Skip to main content
POST
Update an account's metadata

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"

Path Parameters

accountID
string
required

The account id.

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

Body

application/json
metadata
object
required

Replaces the account's metadata with this set. Send the full map you want stored. An empty object clears it. Your own key-value pairs, returned verbatim.

Response

The updated 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.