Contacts

Create a contact

Create a contact.

POST

/business/contacts

Create a contact

curl --request POST \
  --url https://api-example.kickcall.ai/api/v1/business/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contact": {
    "category": "general",
    "phone_number": "+14165551234"
  }
}
'

{
  "associated_records": [
    {
      "first_name": "Vishal",
      "id": 55,
      "last_name": "Garg"
    }
  ],
  "business_id": 286,
  "calls_count": 4,
  "category": "general",
  "chats_count": 1,
  "created_at": "2026-09-01T10:00:00.000Z",
  "id": 1201,
  "latest_interaction_id": 22702,
  "location_id": 340,
  "phone_number": "+14166706230"
}

Audience: Business portal. Auth: Business/agency JWT or API key; usually header Business-Id. Resource: Contacts.

Authorizations

Authorizationstringheaderrequired

JWT from OTP login, or business/agency API key string.

Body

contactobjectrequired

Show child attributes

Response

Created — Created contact

associated_recordsobject[]

Show child attributes

business_idinteger

calls_countinteger

categoryenum<string>

Available options: general, spam, vip

chats_countinteger

created_atstring

idinteger

latest_interaction_idinteger | null

location_idinteger | null

phone_numberstring

Still need help? Ask the team