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.",
  "createdAt" : "2012-07-23T12:34:12Z",
  "updatedAt" : "2012-07-24T20:18:33Z",
  "age" : "30-35",
  "gender" : "Male",
  "organization" : "Acme, Inc"
}

Request fields

Path Type Required Description
firstName String Y First name of the customer. Must be shorter than 40 characters
lastName String N Last name of the customer. Must be shorter than 40 characters
photoUrl String N URL of the customer’s photo
jobTitle String N Job title
photoType String N Type of photo. Possible values include:
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
createdAt String N Time and date when the customer was created (UTC)
updatedAt String N Time and date when the customer was update (UTC)
organization String N Organization
gender String N Gender of this customer. Possible values include:
male
female
unknown
age String N Customer’s age

Response

HTTP/1.1 204 No Content