Skip to main content
PATCH
/
v1
/
contacts
/
{id}
Update Contact
curl --request PATCH \
  --url https://api.mokaru.ai/v1/contacts/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "<string>",
  "lastName": "<string>",
  "jobTitle": {},
  "company": {},
  "relationship": {},
  "email": {},
  "phone": {},
  "linkedIn": {}
}
'
{
  "success": true,
  "id": "<string>"
}

​
Overview

The Update Contact endpoint lets you modify an existing contact’s details. Only include the fields you want to change. Pass null for optional fields to clear them.
Scope required: contacts:write | Rate limit: 20 requests/min

​
Request

PATCH /v1/contacts/{id}

​
Body Parameters

All fields are optional, but at least one must be provided.
​
firstName
string
First name (max 100 characters)
​
lastName
string
Last name (max 100 characters)
​
jobTitle
string | null
Contact’s job title (max 200 characters, null to clear)
​
company
string | null
Company name (max 200 characters, null to clear)
​
relationship
string | null
Relationship type (see Create Contact for values, null to clear)
​
email
string | null
Email address (max 200 characters, null to clear)
​
phone
string | null
Phone number (max 50 characters, null to clear)
​
linkedIn
string | null
LinkedIn profile URL (max 500 characters, null to clear)

​
Example

curl -X PATCH "https://api.mokaru.ai/v1/contacts/clx1234" \
  -H "Authorization: Bearer mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+1 555-0201",
    "relationship": "TEAM_LEAD"
  }'

​
Response

​
success
boolean
Whether the contact was updated
​
id
string
The contact’s ID
{
  "success": true,
  "id": "clx1234..."
}