Sign in
Accounts

Create an account.

post/v2/accounts

Headers

Idempotency-Keystring

Non-empty idempotency key for deduplicating write requests on the same route.

Example:6f31c20e-725c-4be8-96f4-835042f67602

Optional. Duplicate keys within the same company namespace and route return 409.

Request body

namestring required

Human-readable name. Maximum 256 Unicode scalar values.

descriptionstring nullable

Optional description. Maximum 2048 Unicode scalar values.

external_idstring nullable

Optional caller-supplied external identifier. Maximum 256 Unicode scalar values.

ledgerup_customer_idstring uuid nullable

Optional LedgerUp billing customer UUID.

Example request

{
  "name": "Acme",
  "description": "Usage tracked for Acme.",
  "external_id": "crm_acme_001",
  "ledgerup_customer_id": "0194f4e3-a2b7-7c6a-a91c-4f6b4db2a980"
}

Response

Created.

idstring required

LedgerUp account identifier.

external_idstring nullable required

Optional caller-supplied external identifier. Maximum 256 Unicode scalar values.

ledgerup_customer_idstring uuid nullable required

Optional LedgerUp billing customer UUID.

namestring required

Human-readable name. Maximum 256 Unicode scalar values.

descriptionstring nullable required

Optional description. Maximum 2048 Unicode scalar values.

created_atinteger required

Unix timestamp in seconds.

updated_atinteger required

Unix timestamp in seconds.

archived_atinteger required

Unix timestamp in seconds.

Example response

{
  "id": "account_0194f4e3a2b77c6aa91c4f6b4db2a980",
  "external_id": "crm_acme_001",
  "ledgerup_customer_id": "0194f4e3-a2b7-7c6a-a91c-4f6b4db2a980",
  "name": "Acme",
  "description": "Usage tracked for Acme.",
  "created_at": 1767225600,
  "updated_at": 1767225600,
  "archived_at": 1767225600
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.