CRM Service Calls

Patch Contact

Update an existing contact by ID.

Send only the fields you want to change. Unset fields are left unchanged. Returns 400 if no fields are provided.

Path Parameters:

contact_id: The contact's CRM record ID.

Request Body (ContactUpdateRequest): Same fields as POST /contacts, but all optional.

Response: The updated contact object.

patch/crm/contacts/{contact_id}

Request

Base URL
https://fapi.ambivo.com (the document declares no server; this is the origin it was published from)
Auth
API key in header Authorization
TypeScript
https://skmtc.dev/ambivo/apis/ambivo-api/docs/crm/contacts/:contact_id/patch.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

contact_idstring required

Request body

namestring nullable

emailstring nullable

sourcestring nullable

Possible values: Google, Facebook, Youtube, Reddit, Snapchat, Craigslist, Yelp, Linkedin, Incoming-Call, SMS, Referral, Bing, Yahoo, Nextdoor, Unknown, TikTok, Instagram, Billboard Ad

phonestring nullable

commentsstring nullable

statusstring nullable

Possible values: open, assigned, attempted, contacted, meeting-setup, disqualified, incorrect

tagsstring[] nullable

List of tags (maximum 10 tags allowed)

employer_namestring nullable

Company name

professionstring nullable

Occupation

titlestring nullable

Title, indexed for search

ssnstring nullable

SSN - encrypted at rest (format: XXX-XX-XXXX or XXXXXXXXX)

websitestring nullable

URL, maps to vCard

birth_yearinteger nullable

4-digit year (e.g., 1985)

birth_monthinteger nullable

Birth month 1-12

birth_dayinteger nullable

Birth day 1-31

decision_dateinteger nullable

Unix epoch timestamp (seconds)

business_need_descriptionstring nullable

Free text for business need

social_dict_listobject[] nullable

List of social profiles, e.g. [{"type": "linkedin", "url": "https://linkedin.com/in/..."}]

Response

Successful Response

idstring required

first_namestring nullable required

last_namestring nullable required

namestring required

statusstring required

marketing_sourcestring nullable

created_datestring nullable required

updated_datestring nullable required

status_updated_datestring nullable required