Skip to main content
POST
/
accounts
Create an account
curl --request POST \
  --url https://api.chargeapi.co/v1/accounts \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "email": "<string>",
  "type": "individual",
  "default_currency": "<string>",
  "metric_system": "metric",
  "plan": "<string>",
  "preferences": {
    "billing_cycle": null,
    "notifications": null,
    "default_currency": null,
    "default_payment_method": null,
    "reporting_enabled": null,
    "report_frequency": null
  },
  "metadata": {}
}'
{
  "id": null,
  "object": null,
  "business_type": null,
  "billing_details": {
    "billing_address": {
      "city": null,
      "country": null,
      "line1": null,
      "line2": null,
      "postal_code": null,
      "state": null
    }
  },
  "contact": {
    "email": null,
    "name": null,
    "phone": null
  },
  "created": null,
  "default_currency": null,
  "description": null,
  "email": null,
  "metadata": null,
  "metric_system": null,
  "name": null,
  "plan": null,
  "preferences": {
    "billing_cycle": null,
    "notifications": null,
    "default_currency": null,
    "default_payment_method": null,
    "reporting_enabled": null,
    "report_frequency": null
  },
  "registration_number": null,
  "type": null,
  "updated": null,
  "wallet_balance": null
}

Body

application/json
​
name
string
required

Display name of the account.

​
email
string
required

Primary contact email.

​
type
enum<string>
required

Legal entity type.

Available options:
individual,
business
​
default_currency
string

ISO-4217 currency code (e.g., usd).

​
metric_system
enum<string>

Preferred measurement system.

Available options:
metric,
imperial
​
plan
string

Subscription plan (e.g., professional).

​
preferences
any
​
metadata
object

Custom key-value pairs for integration needs.

Response

Returns the newly created Account object.

​
id
string

Unique identifier for the account object.

Example:

null

​
object
string

String representing the object’s type. Always account.

Example:

null

​
business_type
string | null

Type of legal entity associated with the account (e.g., individual, business).

Example:

null

​
billing_details
object

Billing information used for invoicing and reports.

​
contact
object

Primary contact person for the account.

​
created
integer

Time at which the account was created (UNIX timestamp).

Example:

null

​
default_currency
string

Three-letter ISO currency code for default billing and pricing (e.g., usd).

Example:

null

​
description
string | null

Optional internal description or label for the account.

Example:

null

​
email
string | null

Email address associated with the account (may duplicate contact.email).

Example:

null

​
metadata
object

Set of key-value pairs to store custom structured data.

Example:

null

​
metric_system
string | null

Preferred measurement system. Either metric or imperial.

Example:

null

​
name
string | null

Display name or registered name of the account.

Example:

null

​
plan
string

Subscription or feature plan assigned to the fleet (e.g., professional).

Example:

null

​
preferences
object

Account-level preferences for billing, notifications, and reports.

​
registration_number
string | null

Government-issued registration number (for businesses).

Example:

null

​
type
string

Type of account, such as individual or business.

Example:

null

​
updated
integer

Time at which the account was last updated (UNIX timestamp).

Example:

null

​
wallet_balance
integer

Current account wallet balance in the smallest currency unit (e.g., cents).

Example:

null