Create Customer

Create a new customer

post

/v0/customers

Header parameters

Api-KeystringRequired

Your secret API key, available in the developer dashboard. Include this header on every request to authenticate your application.

Body

emailstring · emailRequired

The unique email address of the customer

first_namestringOptional

The first name of the customer (required for individual customers)

Example: John

last_namestringOptional

The last name of the customer (required for individual customers)

Example: Doe

company_namestringOptional

The name of the company (required for corporate customers)

Example: Acme Corporation

typestring · enumRequired

The type of customer

Possible values:

Responses

201

Customer created successfully

application/json

customer_idstring · uuidRequired

The unique identifier for the customer

emailstring · emailRequired

The email address associated with the customer

company_namestringOptional

The name of the company of the business customer

Example: Acme Corporation

typestring · enumRequired

The type of customer

Possible values:

first_namestringOptional

The first name of the individual customer

Example: John

last_namestringOptional

The last name of the individual customer

Example: Doe

post/v0/customers

POST /v0/customers HTTP/1.1
Host: api.alignlabs.dev
Api-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 118

{
  "email": "[e-mail]",
  "first_name": "John",
  "last_name": "Doe",
  "company_name": "Acme Corporation",
  "type": "individual"
}

201

Customer created successfully

{
  "customer_id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "[e-mail]",
  "company_name": "Acme Corporation",
  "type": "individual",
  "first_name": "John",
  "last_name": "Doe"
}