Accounts

Create account

Changed on

Creates a new account.

post/v1/accounts

Request

  • Base URL
    https://api.augustus.com
  • URL
    https://api.augustus.com/v1/accounts
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring required

Idempotency key for safe retries. Reusing a key with an identical request body returns the cached response. Reusing a key with a different body returns 409.

Request body

account_program_idstring uuid required

ID of the account program to create the account under.

account_holder_idstring required

ID of an existing account holder to provision the account for.

metadataobject nullable

Set of up to 50 key-value string pairs you can attach to store structured information, such as correlating this resource with an object in your own system. Keys may be up to 40 characters and values up to 500 characters.

Example request

{
  "account_program_id": "550e8400-e29b-41d4-a716-446655440002",
  "account_holder_id": "68e0a1b2c3d4e5f60718293a",
  "metadata": {
    "invoice_id": "INV-2026-0042"
  }
}

Response

Account created successfully

idstring required

Unique identifier of the account.

type'account' required

Resource type discriminator.

currency'EUR' | 'GBP' | 'USD' | 'USDC' required

Currency code (ISO 4217 or crypto).

status'pending' | 'active' | 'frozen' | 'closed' required

Current status of the account.

asset_type'fiat' | 'crypto' required

Asset type of the account.

labelstring required

Human-readable label for the account. For FBO accounts the label is set to the account holder’s name.

created_atstring date-time required

ISO 8601 UTC timestamp when the account was created.

updated_atstring date-time required

ISO 8601 UTC timestamp when the account was last updated.

metadataobject required

Set of up to 50 key-value string pairs you can attach to store structured information, such as correlating this resource with an object in your own system. Keys may be up to 40 characters and values up to 500 characters.

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "currency": "USD",
  "status": "active",
  "label": "Jane Doe",
  "financial_addresses": [
    {
      "type": "aba",
      "routing_number": "110000000",
      "account_number": "000123456789",
      "account_holder_name": "Acme Sandbox Ltd.",
      "account_type": "checking"
    },
    {
      "type": "bic",
      "bic": "IRVTUS3NXXX",
      "account_number": "000123456789",
      "account_holder_name": "Acme Sandbox Ltd.",
      "local_bank_code": null,
      "account_type": "checking"
    }
  ],
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-01-15T10:35:00Z",
  "metadata": {
    "invoice_id": "INV-2026-0042"
  }
}

Changes