Skip to main content
POST
/
contacts
curl --request POST \
  --url https://api.truedy.ai/api/public/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number": "+15551234567"
}
'
{
  "data": {
    "id": "cnt_d4e5f6a7",
    "name": "Jane Doe",
    "phone": "+12125551234",
    "email": "jane@acme.com",
    "folder_id": "folder_abc123",
    "custom_fields": {
      "company": "Acme Corp",
      "lead_score": "85",
      "region": "Northeast"
    },
    "call_count": 3,
    "last_called_at": "2026-04-04T14:00:00Z",
    "created_at": "2026-03-15T09:00:00Z",
    "updated_at": "2026-04-04T14:00:00Z"
  },
  "meta": {
    "request_id": "req_32e7531c",
    "ts": "2026-04-05T10:22:00Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Include your API key in the Authorization header: Bearer <your_api_key>

Body

application/json
​
phone_number
string
required

Phone number in E.164 format

Pattern: ^\+[1-9]\d{1,14}$
Example:

"+15551234567"

​
first_name
string | null

Contact first name

Maximum string length: 100
Example:

"John"

​
last_name
string | null

Contact last name

Maximum string length: 100
Example:

"Doe"

​
email
string<email> | null

Contact email address

Example:

"john@example.com"

​
custom_fields
object | null

Custom fields

Example:
{ "customer_id": "CUST123" }

Response

Contact created successfully

​
data
object
required
​
meta
object
required