Skip to main content
POST
Add/allow a contact

Authorizations

Authorization
string
header
required

Runtime context-key (rctx_*) issued by the Ravi gateway. Used by ordinary gateway operations; not accepted by Console-only operations. Bootstrap the first key with ravi daemon init-admin-key; rotate, derive, and revoke via the ravi context family. Specs: runtime/context-keys, sdk/auth.

Body

application/json
identity
string
required

Phone, WhatsApp, or platform user id (use --channel/--instance for Slack)

agent
string

Restrict to agent(s), comma-separated

channel
string

Channel for a platform identity: slack, telegram, phone, whatsapp, email

instance
string

Channel instance name or id (required for slack/telegram/discord)

kind
string

Contact kind: person or org

name
string

Contact name

Response

Success — body conforms to the @Returns schema.

{key}
any