post https://api.chartmogul.com/v1/customers//contacts
Creates a contact
object in ChartMogul under the specified customer
within the selected data source
.
Example
curl -X POST "https://api.chartmogul.com/v1/customers/cus_00000000-0000-0000-0000-000000000000/contacts" \
-u YOUR_API_KEY: \
-H "Content-Type: application/json" \
-d '{
"data_source_uuid": "ds_00000000-0000-0000-0000-000000000000",
"first_name": "Adam",
"last_name": "Smith",
"position": 9,
"title": "CEO",
"email": "[email protected]",
"phone": "+1234567890",
"linked_in": "https://linkedin.com/linkedin",
"twitter": "https://twitter.com/twitter",
"notes": "Heading\nBody\nFooter",
"custom": [
{ "key": "Facebook", "value": "https://www.facebook.com/adam.smith" },
{ "key": "date_of_birth", "value": "1985-01-22" }
]
}'
Result Format
{
"uuid": "con_00000000-0000-0000-0000-000000000000",
"customer_uuid": "cus_00000000-0000-0000-0000-000000000000",
"customer_external_id": "customer_001",
"data_source_uuid": "ds_00000000-0000-0000-0000-000000000000",
"position": 9,
"first_name": "Adam",
"last_name": "Smith",
"title": "CEO",
"email": "[email protected]",
"phone": "+1234567890",
"linked_in": "https://linkedin.com/linkedin",
"twitter": "https://twitter.com/twitter",
"notes": "Heading\nBody\nFooter",
"custom": {
"Facebook": "https://www.facebook.com/adam.smith",
"date_of_birth": "1985-01-22"
}
}
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.