Skip to main content
curl -X POST https://api.chargeapi.co/v1/accounts \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "email": "example@example.com",
  "name": "Example",
  "type": "business"
}'

{
    "id": "acct_yYg01pWLFArG9cUEz7yQtqNLkbxFWnqQ",
    "object": "account",
    "billing_details": {
        "billing_address": {
            "city": "Paris",
            "country": "FR",
            "line1": "10 Rue de la Paix",
            "line2": "Batiment A",
            "postal_code": "75002",
            "state": "Ile-de-France"
        }
    },
    "business_type": null,
    "contact": {
        "email": "example@example.com",
        "name": "Example",
        "phone": "+33189000010"
    },
    "created": "2026-04-01T00:34:57.156Z",
    "default_currency": "eur",
    "description": null,
    "email": "example@example.com",
    "metadata": {},
    "metric_system": "metric",
    "name": "Example Account",
    "plan": "professional",
    "preferences": {
        "billing_cycle": "monthly",
        "default_currency": "eur",
        "default_payment_method": null,
        "notifications": true,
        "report_frequency": "weekly",
        "reporting_enabled": true
    },
    "registration_number": null,
    "status": "active",
    "type": "business",
    "updated": "2026-04-01T02:35:21.644Z",
    "wallet_balance": 0
}
Creates an account. Accounts are the top-level container for vehicles, drivers, charging stations, payments, and reporting. Use this endpoint to onboard a fleet, platform integration, or business entity into Charge. 
curl -X POST https://api.chargeapi.co/v1/accounts \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "email": "example@example.com",
  "name": "Example",
  "type": "business"
}'

{
    "id": "acct_yYg01pWLFArG9cUEz7yQtqNLkbxFWnqQ",
    "object": "account",
    "billing_details": {
        "billing_address": {
            "city": "Paris",
            "country": "FR",
            "line1": "10 Rue de la Paix",
            "line2": "Batiment A",
            "postal_code": "75002",
            "state": "Ile-de-France"
        }
    },
    "business_type": null,
    "contact": {
        "email": "example@example.com",
        "name": "Example",
        "phone": "+33189000010"
    },
    "created": "2026-04-01T00:34:57.156Z",
    "default_currency": "eur",
    "description": null,
    "email": "example@example.com",
    "metadata": {},
    "metric_system": "metric",
    "name": "Example Account",
    "plan": "professional",
    "preferences": {
        "billing_cycle": "monthly",
        "default_currency": "eur",
        "default_payment_method": null,
        "notifications": true,
        "report_frequency": "weekly",
        "reporting_enabled": true
    },
    "registration_number": null,
    "status": "active",
    "type": "business",
    "updated": "2026-04-01T02:35:21.644Z",
    "wallet_balance": 0
}

​
Parameters

​
default_currency
string
ISO-4217 currency code.
​
email
string
required
Primary contact email.
​
name
string
required
Display name of the account.
​
plan
string
Subscription plan.
​
type
string
required
Legal entity type.Available options: individual, business

​
More parameters

​
metadata
object
Set of key-value pairs that you can attach to an object.
​
metric_system
string
Preferred measurement system.Available options: metric, imperial
​
preferences
object
Settings for billing, notifications, and reporting.

​
Returns

Returns the created account.