POST
/
customers
curl --request POST \
  --url https://eu.sequencehq.com/api/customers \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "legalName": "John Doe",
  "contactName": "John Doe",
  "address": {
    "line1": "Flat 1",
    "line2": "123 Fake Street",
    "town": "New York",
    "state": "NY",
    "postcode": "AB1 2EF",
    "country": "US"
  },
  "email": "john@example.com",
  "billingEmails": [
    "exampleCorpInvoices@example.com"
  ],
  "telephone": "john@example.com",
  "url": "https://example.com/",
  "label": "Example customer",
  "taxStatus": "TAXED",
  "customerAliases": [
    "b1c87177-088a-40ec-8917-9809343f3f9c"
  ],
  "externalIds": [
    {
      "key": "Xero",
      "value": "123456789"
    },
    {
      "key": "Stripe",
      "value": "cus_OCtCxqQDgu1uX9"
    },
    {
      "key": "HubSpot",
      "value": "123456789"
    }
  ]
}'
{
  "customer": {
    "id": "e309e948-088e-4d77-b654-cd85498f1555",
    "createdAt": "2022-06-28T16:47:00Z",
    "sequenceAccountId": "25b3c342-6fa6-4375-9ed3-616f05abb77a",
    "legalName": "John Doe",
    "contactName": "John Doe",
    "address": {
      "line1": "Flat 1",
      "line2": "123 Fake Street",
      "town": "New York",
      "state": "NY",
      "postcode": "AB1 2EF",
      "country": "US"
    },
    "email": "john@example.com",
    "billingEmails": [
      "exampleCorpInvoices@example.com"
    ],
    "telephone": "02010001000",
    "url": "https://example.com/",
    "taxStatus": "TAXED",
    "label": "Example customer",
    "externalIds": [
      {
        "key": "Xero",
        "value": "ID",
        "syncTime": "2022-06-28T16:47:00Z"
      },
      {
        "key": "Stripe",
        "value": "cus_OCtCxqQDgu1uX9",
        "syncTime": "2022-06-28T16:47:00Z"
      }
    ],
    "archivedAt": "2022-06-28T16:47:00Z"
  }
}

Headers

Authorization
string
required

Your API credentials. Eg. Basic {credentials}.

Body

application/json
legalName
string
required

Legal name

contactName
string

Contact name

address
object
required

Address

email
string
required

Email

billingEmails
string[]
required

Billing email addresses

telephone
string

Telephone

url
string

URL

label
string

Label

taxStatus
enum<string>

Tax status applicable to customer. Can be one of TAXED, EXEMPT or REVERSE_CHARGED. The default is TAXED.

Available options:
TAXED,
TAX_EXEMPT,
REVERSE_CHARGED
customerAliases
string[]

Customer aliases.

externalIds
object[]

IDs in external integrations

Response

201 - application/json
customer
object
required

Customer