Create a Contact

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.
Language
Authentication
Basic
base64
: