patch https://api.chartmogul.com/v1/contacts/
Updates certain modifiable attributes of a contact
object in your ChartMogul account.
Example
curl -X PATCH "https://api.chartmogul.com/v1/contacts/con_00000000-0000-0000-0000-000000000000" \
-u YOUR_API_KEY: \
-H "Content-Type: application/json" \
-d '{
"customer_external_id": "customer_002",
"first_name": "Bill",
"last_name": "Thompson",
"position": 10,
"title": "CTO",
"email": "[email protected]",
"phone": "+987654321",
"linked_in": "https://linkedin.com/bill-linkedin",
"twitter": "https://twitter.com/bill-twitter",
"notes": "New Heading\nNew Body\nNew Footer",
"custom": [
{ "key": "Facebook", "value": "https://www.facebook.com/bill.thompson" },
{ "key": "date_of_birth", "value": "1990-01-01" }
]
}'
Result Format
{
"uuid": "con_00000000-0000-0000-0000-000000000000",
"customer_uuid": "cus_00000000-0000-0000-0000-000000000000",
"customer_external_id": "customer_002",
"data_source_uuid": "ds_00000000-0000-0000-0000-000000000000",
"first_name": "Bill",
"last_name": "Thompson",
"position": 10,
"title": "CTO",
"email": "[email protected]",
"phone": "+9876543210",
"linked_in": "https://linkedin.com/bill-linkedin",
"twitter": "https://twitter.com/bill-twitter",
"notes": "New Heading\nNew Body\nNew Footer",
"custom": [
{ "key": "Facebook", "value": "https://www.facebook.com/bill.thompson" },
{ "key": "date_of_birth", "value": "1990-01-01" }
]
}
In the response, the JSON
object contains the following data:
uuid
: The UUID of the contact.customer_uuid
: The UUID of the customer to which this contact belongs.customer_external_id
: The external id of the customer to which this contact belongs.data_source_uuid
: The UUID of the data source of the customer to which this contact belongs. A user can have multiple data sources, and the contact should only be associated to one of them.position
: Position of the contact in the customer’s profile.first_name
: The first name of the contact.last_name
: The last name of the contact.title
: The job title of the contact.email
: The email address of the contact.phone
: The phone number of the contact.linked_in
: The URL of the contact's LinkedIn profile.twitter
: The URL of the contact's Twitter profile.notes
: Additional notes or comments about the contact.custom
: A dictionary of custom fields and their values that are specific to this contact. If no custom attributes are set to a contact, this will be an empty object.