Update a Contact

Updates certain modifiable attributes of a contact object in your ChartMogul account.

Example

curl -X PATCH "https://api.chartmogul.com/v1/contacts/con_f90ba380-57a8-11ee-9500-7f50256329a7" \
     -u YOUR_API_KEY: \
     -H "Content-Type: application/json" \
     -d '{
            "first_name": "Bill",
            "last_name": "Thompson",
            "position": 10,
            "title": "CTO",
            "email": "[email protected]",
            "phone": "+987654321",
            "linked_in": "https://linkedin.com/example",
            "twitter": "https://twitter.com/example",
            "notes": "New Heading\nNew Body\nNew Footer",
            "custom": [
              { "key": "Facebook", "value": "https://www.facebook.com/example" },
              { "key": "date_of_birth", "value": "1990-01-01" }
            ]
         }'
contact = ChartMogul::Contact.retrieve('con_f90ba380-57a8-11ee-9500-7f50256329a7')

contact.first_name = 'Bill'
contact.last_name = 'Thompson'
contact.email = '[email protected]'
contact.title = 'CTO'
contact.position = 10
contact.phone = '+987654321'
contact.linked_in = 'https://linkedin.com/example'
contact.twitter = 'https://twitter.com/example'
contact.notes = 'New Heading\nNew Body\nNew Footer'
contact.custom = {
  Facebook: 'https://facebook.com/example',
  date_of_birth: '1990-01-01'
}

contact.update!
const contactUuid = "con_f90ba380-57a8-11ee-9500-7f50256329a7";

const data = {
  first_name: "Bill",
  last_name: "Thompson",
  position: 10,
  title: "CTO",
  email: "[email protected]",
  phone: "+987654321",
  linked_in: "https://linkedin.com/example",
  twitter: "https://twitter.com/example",
  notes: "New Heading\nNew Body\nNew Footer",
  custom: [
    { key: "Facebook", value: "https://www.facebook.com/example" },
    { key: "date_of_birth", value: "1990-01-01" }
  ]
};

ChartMogul.Contact.modify(config, contactUuid, data);
<?php

ChartMogul\Contact::update([
  "contact_uuid" => "con_f90ba380-57a8-11ee-9500-7f50256329a7",
  ], [
  "first_name" => "Bill",
  "last_name" => "Thompson",
  "position" => 10,
  "title" => "CTO",
  "email" => "[email protected]",
  "phone" => "+987654321",
  "linked_in" => "https://linkedin.com/example",
  "twitter" => "https://twitter.com/example",
  "notes" => "New Heading\nBody\nFooter",
  "custom" => [
    [ "key" => "Facebook", "value" => "https://www.facebook.com/example" ],
    [ "key" => "date_of_birth", "value" => "1990-01-01" ]
  ],
]);
?>
api.UpdateContact(&cm.UpdateContact{
  FirstName: "Bill",
  LastName:  "Thompson",
  LinkedIn:  "https://linkedin.com/example",
  Notes:     "New Heading\nNew Body\nNew Footer",
  Phone:     "+987654321",
  Position:  10,
  Title:     "CTO",
  Twitter:   "https://twitter.com/example",
  Custom: []cm.Custom{
    {
      Key:   "Facebook",
      Value: "https://www.facebook.com/example",
    },
    {
      Key:   "date_of_birth",
      Value: "1990-01-01",
    },
  },
}, "con_f90ba380-57a8-11ee-9500-7f50256329a7")
chartmogul.Contact.modify(
    config,
    uuid="con_f90ba380-57a8-11ee-9500-7f50256329a7",
    data={
      "first_name": "Bill",
      "last_name": "Thompson",
      "position": 10,
      "title": "CTO",
      "email": "[email protected]",
      "phone": "+987654321",
      "linked_in": "https://linkedin.com/example",
      "twitter": "https://twitter.com/example",
      "notes": "New Heading\nNew Body\nNew Footer",
      "custom": [
        { "key": "Facebook", "value": "https://www.facebook.com/example" },
        { "key": "date_of_birth", "value": "1990-01-01" }
      ]
    })

Result Format

{
  "uuid": "con_f90ba380-57a8-11ee-9500-7f50256329a7",
  "customer_uuid": "cus_52eb54c2-dea0-11ed-ac96-ef735d89fca0",
  "customer_external_id": "customer_001",
  "data_source_uuid": "ds_a0767e0a-515b-11ee-b531-07b8fff1bb01",
  "first_name": "Bill",
  "last_name": "Thompson",
  "position": 10,
  "title": "CTO",
  "email": "[email protected]",
  "phone": "+9876543210",
  "linked_in": "https://linkedin.com/example",
  "twitter": "https://twitter.com/example",
  "notes": "New Heading\nNew Body\nNew Footer",
  "custom": [
    { "key": "Facebook", "value": "https://www.facebook.com/example" },
    { "key": "date_of_birth", "value": "1990-01-01" }
  ]
}
#<ChartMogul::Contact:0x0000000128fada38
  @custom={
    :Facebook=>'https://facebook.com/example',
    :date_of_birth=>'1990-01-01'
  },
  @customer_external_id="customer_001",
  @customer_uuid="cus_52eb54c2-dea0-11ed-ac96-ef735d89fca0",
  @data_source_uuid="ds_a0767e0a-515b-11ee-b531-07b8fff1bb01",
  @email="[email protected]",
  @first_name='Bill',
  @last_name='Thomposon',
  @linked_in='https://linkedin.com/example',
  @notes='New Heading\nBody\nFooter',
  @phone='+987654321',
  @position=10,
  @title='CTO',
  @twitter='https://twitter.com/example',
  @uuid="con_f90ba380-57a8-11ee-9500-7f50256329a7">
{
  "uuid": "con_f90ba380-57a8-11ee-9500-7f50256329a7",
  "customer_uuid": "cus_52eb54c2-dea0-11ed-ac96-ef735d89fca0",
  "customer_external_id": "customer_001",
  "data_source_uuid": "ds_a0767e0a-515b-11ee-b531-07b8fff1bb01",
  "first_name": "Bill",
  "last_name": "Thompson",
  "position": 10,
  "title": "CTO",
  "email": "[email protected]",
  "phone": "+9876543210",
  "linked_in": "https://linkedin.com/example",
  "twitter": "https://twitter.com/example",
  "notes": "New Heading\nNew Body\nNew Footer",
  "custom": [
    { "key": "Facebook", "value": "https://www.facebook.com/example" },
    { "key": "date_of_birth", "value": "1990-01-01" }
  ]
}
class ChartMogul\Contact (15) {
  protected $uuid =>
  string(40) "con_f90ba380-57a8-11ee-9500-7f50256329a7"
  protected $customer_uuid =>
  string(40) "cus_52eb54c2-dea0-11ed-ac96-ef735d89fca0"
  protected $data_source_uuid =>
  string(39) "ds_a0767e0a-515b-11ee-b531-07b8fff1bb01"
  protected $customer_external_id =>
  string(5) "customer_001"
  protected $first_name =>
  string(4) "Bill"
  protected $last_name =>
  string(8) "Thompson"
  protected $position =>
  int(10)
  protected $email =>
  string(16) "[email protected]"
  protected $title =>
  string(3) "CTO"
  protected $notes =>
  string(23) "New Heading\nBody\nFooter"
  protected $phone =>
  string(10) "+987654321"
  protected $linked_in =>
  string(34) "https://linkedin.com/example"
  protected $twitter =>
  string(32) "https://twitter.com/example"
  protected $custom =>
  array(2) {
    "Facebook" =>
    string(38) "https://www.facebook.com/example"
    "date_of_birth" =>
    string(10) "1990-01-01"
  }
}
(*chartmogul.Contact)(0x1400018a300)({
  UUID: (string) (len=40) "con_f90ba380-57a8-11ee-9500-7f50256329a7",
  CustomerExternalID: (string) (len=12) "customer_001",
  CustomerUUID: (string) (len=40) "cus_52eb54c2-dea0-11ed-ac96-ef735d89fca0",
  DataSourceUUID: (string) (len=39) "ds_a0767e0a-515b-11ee-b531-07b8fff1bb01",
  FirstName: (string) (len=4) "Bill",
  LastName: (string) (len=8) "Thompson",
  LinkedIn: (string) (len=34) "https://linkedin.com/example",
  Notes: (string) (len=31) "New Heading\nNew Body\nNew Footer",
  Phone: (string) (len=10) "+987654321",
  Position: (uint32) 10,
  Title: (string) (len=3) "CTO",
  Twitter: (string) (len=32) "https://twitter.com/example",
  Custom: (map[string]interface {}) (len=2) {
    (string) (len=8) "Facebook": (string) (len=35) "https://www.facebook.com/example",
    (string) (len=13) "date_of_birth": (string) (len=10) "1990-01-01"
  }
})
<Contact{
    custom={'Facebook': 'https://www.facebook.com/example','date_of_birth': '1990-01-01'},
    customer_external_id='external_001',
    customer_uuid='cus_52eb54c2-dea0-11ed-ac96-ef735d89fca0',
    data_source_uuid='ds_a0767e0a-515b-11ee-b531-07b8fff1bb01',
    email='[email protected]',
    first_name='Bill',
    last_name='Thompson',
    linked_in='https://linkedin.com/example',
    notes='New Heading\nNew Body\nNew Footer',
    phone='+987654321',
    position=10,
    title='CTO',
    twitter='https://twitter.com/example'
    uuid='con_f90ba380-57a8-11ee-9500-7f50256329a7'}>

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