Create a customer record

Creates a customer record with information about a person or organization making Toast platform payments.

SecurityOAuth2
Request
header Parameters
Toast-Restaurant-External-ID
required
string <string>

The identifier of the restaurant location.

Request Body schema: */*
description
string

A brief description of the customer, such as an email address, name, or phone number.

externalReferenceId
string

Represents the customer's identity in your integration. This can be the primary key for your customer, an unique UUID, an email address, or any other value.

Responses
200

Successful operation. Customer record created.

400

The request to create a customer record was not correctly formed or could not be processed successfully.

401

Your client is not authorized to use the API endpoint.

500

Internal server error.

post/v1/customers
Request samples
curl -i -X POST \
  https://toast-api-server/v1/customers \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: */*' \
  -H 'Toast-Restaurant-External-ID: string' \
  -d '[object Object]'
Response samples
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "externalReferenceId": "string",
  • "description": "string"
}