Create Contact

Creates a new contact. Only phone_number is required. Custom properties go inside the attributes JSON object.

POST/api/v1/contact/create

Request Body Schema

application/json

phone_numberstringrequired

Contact phone number with country code (e.g. +917838343515)

Example:+917838343515

first_namestringoptional

Contact first name

Example:Jane

last_namestringoptional

Contact last name

attributesobjectoptional

Custom key-value properties

Example:{"email": "[email protected]"}

Response Payload

200 OKapplication/json

successbooleanrequired

Whether request succeeded

data.contact.iduuidrequired

Newly created contact UUID

data.contact.phone_numberstringrequired

Phone number

data.contact.first_namestringoptional

First name

data.contact.attributesobjectoptional

Custom fields

data.contact.created_atdatetimerequired

Creation timestamp

Code Snippets & Examples

curl -X POST "https://app.chatofy.in/api/v1/contact/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"+917838343515","first_name":"Jane","attributes":{"email":"[email protected]"}}'

Was this endpoint guide helpful?

Enterprise SLA•99.99% Guaranteed

curl -X POST "https://app.chatofy.in/api/v1/contact/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"+917838343515","first_name":"Jane","attributes":{"email":"[email protected]"}}'

200 OKapplication/json

{
  "success": true,
  "data": {
    "contact": {
      "id": "d9b23f28-0db4-...",
      "phone_number": "+917838343515",
      "first_name": "Jane",
      "last_name": null,
      "attributes": {
        "email": "[email protected]"
      },
      "created_at": "2026-06-06T06:41:59.786Z"
    }
  },
  "message": "Contact created successfully"
}

curl -X POST "https://app.chatofy.in/api/v1/contact/create" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"phone_number":"+917838343515","first_name":"Jane","attributes":{"email":"[email protected]"}}'

{ "success": true, "data": { "contact": { "id": "d9b23f28-0db4-...", "phone_number": "+917838343515", "first_name": "Jane", "last_name": null, "attributes": { "email": "[email protected]" }, "created_at": "2026-06-06T06:41:59.786Z" } }, "message": "Contact created successfully" }