We're upgrading our API

On June 6th, 2019, Mailbox API 1.0 will be sunsetted, and at that time any apps using this legacy API will no longer work. Please use Mailbox API 2.0 instead.

Create Customer

  • REST Method: POST
  • URL: https://api.helpscout.net/v1/customers.json
  • Content-Type: application/json


Name Type Required Default Notes
customer Customer Y   The body of the request (see example below).
reload boolean N false Set this request parameter to true to return the customer in the response.
    "firstName": "Vernon",
    "lastName": "Bear",
    "organization": "Acme, Inc",
    "jobTitle": "CEO and Co-Founder",
    "background": "I've worked with Vernon before and he's really great.",
    "address": {
        "lines": [
            "123 West Main St",
            "Suite 123"
        "city": "Dallas",
        "state": "TX",
        "postalCode": "74206",
        "country": "US",
        "createdAt": "2012-07-23T12:34:12Z"
        "modifiedAt": "2012-07-24T20:18:33Z"
    "socialProfiles": [
            "value": "https://twitter.com/helpscout",
            "type": "twitter"
        {... social profile object ...}
    "emails": [{
            "value": "vbear@mywork.com",
            "location": "work"
        {... email object ...}
    "phones": [{
            "value": "222-333-4444",
            "location": "home"
        {... phone object ...}
    "chats": [{
            "value": "jsprout",
            "type": "aim"
        {... chat object ...}
    "websites": [{
            "value": "http://www.somewhere.com"
        {... website object ...}

Accepted Fields

Name Type Required Default Notes
firstName string Y    
lastName string Y    
emails Collection Y   Collection of CustomerEmail objects. At least one email address is required.
organization string N    
jobTitle string N    
background string N    
address CustomerAddress N    
socialProfiles Collection N   Collection of CustomerSocialProfile objects.
phones Collection N   Collection of CustomerPhone objects.
chats Collection N   Collection of CustomerChat objects.
websites Collection N   Collection of CustomerWebsite objects.


Response Name Type Notes
Header Status Integer 201
Header Location String https://api.helpscout.net/v1/customer/{id}.json
Status: 201 Created
Location: https://api.helpscout.net/v1/customer/{id}.json