Skip to main content
POST
Create an account for a customer

Authorizations

Authorization
string
header
required

Your API key, e.g. Authorization: Bearer clmt_test_. Live keys use the clmt_live_ prefix.

Headers

Clemta-Version
string

Date-based API version to run this request against.

Example:

"2026-08-13"

Body

application/json
first_name
string
required

The customer's first name.

Required string length: 1 - 100
Pattern: ^[^\r\n\t]+$
last_name
string
required

The customer's last name.

Required string length: 1 - 100
Pattern: ^[^\r\n\t]+$
email
string<email>
required

The customer's email, stored as contact data only.

Maximum string length: 254
external_id
string

Your own identifier for this account. Must be unique across your accounts. Reusing one is rejected. Use Idempotency-Key to retry safely.

Required string length: 1 - 255
phone
string

The customer's phone number, optional. Digits with optional +, spaces, and ().-` separators.

Required string length: 7 - 20
Pattern: ^[0-9+()\s.-]+$
metadata
object

Your own key-value pairs, stored and returned verbatim.

Response

The created account.

object
enum<string>
required

Entity name. Identifies this object when it arrives without its URL.

Available options:
account
id
string
required

Identifier of the account.

Pattern: ^acct_[0-9A-Za-z]{22}$
Example:

"acct_0346sFPEvSkJvY8vt14NNw"

livemode
boolean
required

Whether this account was created with a live key.

first_name
string
required

The customer's first name.

last_name
string
required

The customer's last name.

email
string<email>
required

The customer's email. Stored as contact data only - the customer never receives any message from Clemta.

created_at
string<date-time>
required
external_id
string

Your own identifier for this account, unique across your accounts.

phone
string

The customer's phone number, optional, stored as contact data.

metadata
object

Your own key-value pairs, stored and returned verbatim. Clemta never reads them. Use them to correlate the account with your system.