Contacts

Contacts are people associated with Accounts. Create, read, and update contacts linked to your accounts.

Lead vs Contact: A Lead is an unqualified prospect. Once qualified and converted to an Account, the person becomes a Contact. Contacts belong to Accounts; Leads are standalone.

GET/contacts

List all contacts in your tenant.

Request

curl -X GET "https://kashew.ai/api/v1/contacts" \
  -H "Authorization: Bearer kshw_xxxxxxxx_xxxxx..."

200Response

{
  "contacts": [
    {
      "id": "contact-uuid",
      "account_id": "account-uuid",
      "first_name": "Rahul",
      "last_name": "Sharma",
      "email": "rahul@techstart.io",
      "phone": "+919876543210",
      "job_title": "VP Engineering",
      "created_at": "2026-05-28T10:00:00Z"
    }
  ],
  "count": 1
}

GET/contacts/{contact_id}

Get a single contact by ID.

Request

curl -X GET "https://kashew.ai/api/v1/contacts/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "Authorization: Bearer kshw_xxxxxxxx_xxxxx..."

POST/contacts

Create a new contact on an account.

Request Body

Parameter	Type	Description
account_id	uuid	ID of the account this contact belongs to (required)
first_name	string	First name (required)
last_name	string	Last name
email	string	Email address
phone	string	Phone number
job_title	string	Job title

account_id(uuid)

ID of the account this contact belongs to (required)

first_name(string)

First name (required)

last_name(string)

Last name

email(string)

Email address

phone(string)

Phone number

job_title(string)

Job title

Request

curl -X POST "https://kashew.ai/api/v1/contacts" \
  -H "Authorization: Bearer kshw_xxxxxxxx_xxxxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "586a16a1-8a9c-4053-92a7-b565ca882b15",
    "first_name": "Rahul",
    "last_name": "Sharma",
    "email": "rahul@techstart.io",
    "phone": "+919876543210",
    "job_title": "VP Engineering"
  }'

201Response

{ "id": "contact-uuid", "status": "created" }

PATCH/contacts/{contact_id}

Update a contact. Send only the fields you want to change.

Request Body

Parameter	Type	Description
first_name	string	First name
last_name	string	Last name
email	string	Email address
job_title	string	Job title

first_name(string)

First name

last_name(string)

Last name

email(string)

Email address

job_title(string)

Job title

Request

curl -X PATCH "https://kashew.ai/api/v1/contacts/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "Authorization: Bearer kshw_xxxxxxxx_xxxxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "job_title": "CTO",
    "email": "rahul.new@techstart.io"
  }'

200Response

{ "id": "contact-uuid", "status": "updated" }