Create a widget for an agent

POSThttps://server.heyrik.com/api/v1/widgets

Headers

AuthorizationstringRequired

Use Bearer $HEYRIK_API_KEY with an account-scoped API key. Keep the key on your server.

Get your API key

Parameters 3

Fields documented for this operation. See the request example for placement and structure.

agency_idstringRequired

Agent that answers.

namestring

Label.

allowed_originsarray

Domains allowed to embed it — lock this down.

Response

No response example is documented for this operation yet.

Error reference
POST/widgets
cURL
curl -X POST https://server.heyrik.com/api/v1/widgets \
  -H "Authorization: Bearer $HEYRIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agency_id": "agc_9f2a1c30",
    "name": "Website chat",
    "allowed_origins": ["https://acme.com"]
  }'

Illustrative examples · No live request is sent

Docs

Build sophisticated voice experiences with HeyRik.

© 2026 HeyRik · Support