Update Customer

This endpoint only updates the following fields (i.e. the Customer entity), to update additional customer information please see:

There are similar endpoints to delete or add customer data.

Request

PUT /v2/customers/101 HTTP/1.1
Authorization: Bearer oauth_token
Content-Type: application/json; charset=UTF-8

{
  "firstName" : "Vernon",
  "lastName" : "Bear",
  "photoUrl" : "https://api.helpscout.net/img/some-avatar.jpg",
  "photoType" : "twitter",
  "jobTitle" : "CEO and Co-Founder",
  "location" : "Greater Dallas/FT Worth Area",
  "background" : "I've worked with Vernon before and he's really great.",
  "age" : "30-35",
  "gender" : "Male",
  "organization" : "Acme, Inc"
}

Path Parameters

/v2/customers/{customerId}

Request fields

Path Type Required Description
firstName String N First name of the customer. When defined it must be between 1 and 40 characters.
lastName String N Last name of the customer. When defined it must be between 1 and 40 characters.
phone String N Optional phone number that will be used when creating a new customer
photoUrl String N URL of the customer’s photo
jobTitle String N Job title
photoType String N Type of photo. Accepted values are:
unknown
gravatar
twitter
facebook
googleprofile
googleplus
linkedin
background String N This is the Notes field from the user interface.
location String N Location of the customer
organization String N Organization
gender String N Gender of this customer. Accepted values are:
male
female
unknown
age String N Customer’s age

Response

HTTP/1.1 204 No Content