Skip to main content
POST
/
v0
/
assistant
/
{assistant_id}
/
contact
curl --request POST \
  --url 'https://api.unify.ai/v0/assistant/<assistant_id>/contact' \
  --header "Authorization: Bearer $UNIFY_KEY"
  --header 'Content-Type: application/json' \
  --data '{
    "contact_type": "phone",
    "phone_country": "US",
    "user_phone": "+15551234567",
    "email_local": "ada.lovelace",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "user_whatsapp_number": "+15551234567"
}'
{
    "info": "object"
}
Provisions external infrastructure (phone number, email, or WhatsApp sender) for the given assistant and creates a billing-tracked AssistantContact record. Deducts the one-time setup cost from credits.

Authorizations

Authorization
string
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

assistant_id
integer
required

Body

contact_type
string
required
The type of contact detail to create.
phone_country
string | null
default:"US"
Country code for phone number provisioning (e.g., ‘US’, ‘GB’). Only used for phone contacts.
user_phone
string | null
User’s personal phone number (for forwarding). Only used for phone contacts.
email_local
string | null
Local part of the email address (before @). Only used for email contacts.
first_name
string | null
First name for Google Workspace account. Only used for email contacts.
last_name
string | null
Last name for Google Workspace account. Only used for email contacts.
user_whatsapp_number
string | null
User’s WhatsApp number to associate with the sender. Only used for WhatsApp contacts.
curl --request POST \
  --url 'https://api.unify.ai/v0/assistant/<assistant_id>/contact' \
  --header "Authorization: Bearer $UNIFY_KEY"
  --header 'Content-Type: application/json' \
  --data '{
    "contact_type": "phone",
    "phone_country": "US",
    "user_phone": "+15551234567",
    "email_local": "ada.lovelace",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "user_whatsapp_number": "+15551234567"
}'
{
    "info": "object"
}