Customers

Create a new customer

Changed on
post/v1/customers

Request

Request body

activeboolean

Active

cellPhonestring nullable

Cell phone number

companyNamestring nullable

Company name

emailstring nullable

Email

firstNamestring nullable

First name

internalIdstring nullable

ID used in information system

internalNotesstring nullable

Internal notes

lastNamestring nullable

Last name

metadataobject nullable

Metadata: free-form key/value pairs carried with the customer, for an integration to keep its own identifiers and flags against it.

Sent as a PATCH, not a replacement: keys you send are added or updated, keys you leave out keep whatever they held, and a key is removed only when you send it as null. Omitting the property entirely leaves the whole bag untouched, and "" stores an empty value rather than removing the key.

namestring nullable

Name

numberstring nullable

Number

phonestring nullable

Phone number

titlestring nullable

Title

type'Business' | 'Consumer' | 'Government'

Response

OK

activeboolean

Active

cellPhonestring nullable

Cell phone number

companyNamestring nullable

Company name

emailstring nullable

Email

firstNamestring nullable

First name

idinteger

Customer ID

internalIdstring nullable

ID used in information system

internalNotesstring nullable

Internal notes

lastNamestring nullable

Last name

metadataobject nullable

Metadata: free-form key/value pairs carried with the customer, for an integration to keep its own identifiers and flags against it.

Sent as a PATCH, not a replacement: keys you send are added or updated, keys you leave out keep whatever they held, and a key is removed only when you send it as null. Omitting the property entirely leaves the whole bag untouched, and "" stores an empty value rather than removing the key.

namestring nullable

Name

numberstring nullable

Number

phonestring nullable

Phone number

titlestring nullable

Title

type'Business' | 'Consumer' | 'Government'

Changes

    • breaking

      removed the media type application/json-patch+json from the request body

    • info

      added the new optional request property (media type: application/json)

    • info

      added the new optional request property (media type: text/json)

    • info

      added the new optional request property (media type: application/*+json)

    • info

      added the optional property to the response with the status