Skip to content

Update a customer contact

Request

Update an existing customer contact with full or partial modifications. Supports add/update/delete semantics for contact methods (emails, phones) and overwriting of web/social links and location data.

Security
BearerAuth
Path
idstringrequired
Example:eaafecfe-8c33-428a-88bd-ba4d012793aa
Bodyapplication/jsonrequired
first_namestring, <= 1500 characters
Example:"John"
last_namestring, <= 1500 characters
Example:"Doe"
avatar_urlstring, (uri), <= 1500 characters

See RFC 3986 for URI syntax.

Example:"https://avatar.example.com/john"
email_addressesArray of objects, <= 10 items(ContactMethodEntry)

Email entries to add, update, or delete. Maximum 10 per contact. Duplicate email values (case-insensitive) are silently ignored.

phone_numbersArray of objects, <= 10 items(ContactMethodEntry)

Phone entries to add, update, or delete. Maximum 10 per contact. Duplicate phone values are silently ignored.

urlsobject(WebLinks)

Web links keyed by subtype. One entry per subtype. Set a value to an empty string to delete that subtype entry.

socialobject(SocialLinks)

Social profile links keyed by subtype. One entry per subtype. Set a value to an empty string to delete that subtype entry.

locationobject(ContactLocation)

Contact location. At least one field must be non-empty.

custom_fieldsobject(CustomFields)

Custom fields keyed by field name. Values are user-defined and may be any JSON scalar. Present as {} when the contact has none set.

Example:
{ "DOB": "14/08/1999" }
curl -i -X PUT \
  https://developer.setmore.com/api/v2/customers/eaafecfe-8c33-428a-88bd-ba4d012793aa \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "email_addresses": [
      {
        "value": "newemail@gmail.com",
        "primary": true
      },
      {
        "id": "em_102",
        "deleted": true
      }
    ],
    "phone_numbers": [
      {
        "id": "ph_201",
        "value": "+919399339900"
      },
      {
        "id": "ph_202",
        "deleted": true
      }
    ],
    "urls": {
      "meeting": "https://meet.example.com/john-updated",
      "scheduling": ""
    },
    "social": {
      "facebook": "",
      "instagram": "https://instagram.com/john"
    },
    "location": {
      "address": "456 New Address",
      "city": "Mumbai"
    }
  }'

Responses

Customer contact updated successfully.

Bodyapplication/json
dataobject(Contact)

Contact object returned in API responses. urls, social, and custom_fields are always present, as {} when the contact has none set. They are never omitted.

Response
{ "data": { "id": "eaafecfe-8c33-428a-88bd-ba4d012793aa", "first_name": "Henry", "last_name": "Doe", "phone_numbers": [ … ], "email_addresses": [ … ], "urls": { … }, "social": { … }, "location": { … }, "custom_fields": { … } } }