PUT (update) a Contact

The PUT method updates an existing contact. You must include the update_source property in the PUT request payload. To restore a deleted contact you must specify the update_source as Account. When updating any resource using PUT, all properties are updated, overwriting all previous values. Any properties left blank or not included in the request are overwritten with null value - however this does not apply to contact subresources.

Add or change any of the subresources by including them in the PUT request payload. Omitted subresources are not overwritten with null. If the contact being updated is deleted, the contact will be revived. If email_address is specified: <div class="Msg"><p class="note-text"> **Only use this method when a contact gives you their explicit permission to send them an email. It is a violation of anti-spam and telemarketing laws, as well as a serious violation of the Constant Contact Terms of Service to use the Opt-in features of the API to opt a contact back in without his or her own action and consent.</p></div>

If sms_channel is specified: <div class="Msg"><p class="note-text">Only use this method when a contact gives you their explicit permission to send them an SMS. It is a violation of anti-spam and telemarketing laws, as well as a serious violation of the Constant Contact Terms of Service to use the Opt-in features of the API to opt a contact back in without his or her own action and consent.</p></div>

contact_idstring required

Unique ID of contact to update

Request body

first_namestring

The contact's first name

last_namestring

The contact's last name

job_titlestring

The contact's job title

company_namestring

Name of the company the contact works for.

birthday_monthinteger

Accepts values from 1-12; must be used with <code>birthday_day</code>

birthday_dayinteger

Accepts values from 1-31; must be used with <code>birthday_month</code>

anniversarystring

The anniversary date; Accepted formats are MM/DD/YYYY, M/D/YYYY, YYYY/MM/DD, YYYY/M/D, YYYY-MM-DD, YYYY-M-D, MM-DD-YYYY, M-D-YYYY

update_sourcestring required

Identifies who last updated the contact; valid values are <code>Contact</code> or <code>Account</code>.

list_membershipsstring[]

Array of up to 50 <code>list_ids</code> to which the contact is subscribed.

taggingsstring[]

Array of tags (<code>tag_id</code>) assigned to the contact, up to a maximum of 50.

Example request

{
  "email_address": {
    "address": "dlang@example.com",
    "permission_to_send": "implicit",
    "created_at": "2016-03-03T10:53:04-05:00",
    "updated_at": "2016-03-03T10:56:29-05:00",
    "opt_in_date": "2016-01-23T13:48:44.108Z",
    "opt_out_source": "Contact",
    "opt_out_date": "2016-01-23T13:48:44.108Z",
    "opt_out_reason": "I am no longer interested in this service.",
    "confirm_status": "confirmed"
  },
  "first_name": "Debora",
  "last_name": "Lang",
  "job_title": "Musician",
  "company_name": "Acme Corp.",
  "birthday_month": 11,
  "birthday_day": 24,
  "anniversary": "2006-11-15",
  "update_source": "Account",
  "custom_fields": [
    {
      "custom_field_id": "1618ae62-4752-11e9-9c8a-fa163e6b01c1",
      "value": "Tesla S 2017",
      "choice_ids": [
        "000001"
      ]
    }
  ],
  "phone_numbers": [
    {
      "phone_number": "+1-555-555-5555",
      "kind": "home"
    }
  ],
  "street_addresses": [
    {
      "kind": "home",
      "street": "123 Kashmir Valley Road",
      "city": "Chicago",
      "state": "Illinois",
      "postal_code": "60609",
      "country": "United States"
    }
  ],
  "list_memberships": [
    "07936f78-662a-11eb-af0a-fa163e56c9b0"
  ],
  "taggings": [
    "e7ddac60-51da-11eb-b3a4-fa163e6b01c1"
  ],
  "notes": [
    {
      "note_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "created_at": "2021-05-12T13:48:44.108Z",
      "content": "This contact resubscribed on 2021-05-12."
    }
  ],
  "sms_channel": {
    "full_sms_address": "17815551212",
    "sms_channel_consents": [
      {
        "sms_consent_permission": "explicit",
        "consent_type": "promotional_sms",
        "consent_medium_details": "IPhone 13 device used to provide consent."
      }
    ]
  }
}

Response

Contact resource has been updated

contact_idstring uuid

Unique ID for each contact resource

first_namestring

The first name of the contact.

last_namestring

The last name of the contact.

job_titlestring

The job title of the contact.

company_namestring

The name of the company where the contact works.

birthday_monthinteger

The month value for the contact's birthday. Valid values are from 1 through 12. You must use this property with <code>birthday_month</code>.

birthday_dayinteger

The day value for the contact's birthday. Valid values are from 1 through 12. You must use this property with <code>birthday_day</code>.

anniversarystring

The anniversary date for the contact. For example, this value could be the date when the contact first became a customer of an organization in Constant Contact. Valid date formats are MM/DD/YYYY, M/D/YYYY, YYYY/MM/DD, YYYY/M/D, YYYY-MM-DD, YYYY-M-D,M-D-YYYY, or M-DD-YYYY.

update_sourcestring

Identifies who last updated the contact; valid values are <code>Contact</code> or <code>Account</code>.

create_sourcestring

Describes who added the contact; valid values are <code>Contact</code> or <code>Account</code>. Your integration must accurately identify <code>create_source</code> for compliance reasons; value is set when contact is created.

created_atstring date-time

System generated date and time that the resource was created, in ISO-8601 format.

updated_atstring date-time

System generated date and time that the contact was last updated, in ISO-8601 format.

deleted_atstring date

For deleted contacts (<code>email_address</code> contains <code>opt_out_source</code> and <code>opt_out_date</code>), shows the date of deletion.