> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargeapi.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Update an Account

Updates an account. Parameters you omit keep their current values.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.chargeapi.co/v1/accounts/acct_R0WW9U61sLoQP1WdE5Mw0W9Vqlbnk6tA \
    -H "Authorization: Bearer ch_sk_test_..." \
    --json '{
    "metadata": {
      "account_segment": "enterprise"
    }
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
      "id": "acct_R0WW9U61sLoQP1WdE5Mw0W9Vqlbnk6tA",
      "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:12:16.501Z",
      "default_currency": "eur",
      "description": null,
      "email": "example@example.com",
      "metadata": {
          "account_segment": "enterprise"
      },
      "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:11:41.598Z",
      "wallet_balance": 42850
  }
  ```
</ResponseExample>

## Parameters

<ParamField body="description" type="string">
  Internal description or note.
</ParamField>

<ParamField body="email" type="string">
  Updated contact email.
</ParamField>

<ParamField body="name" type="string">
  New display name for the account.
</ParamField>

<ParamField body="plan" type="string">
  Change the subscription plan.
</ParamField>

## More parameters

<ParamField body="metadata" type="object">
  Set of key-value pairs that you can attach to an object.
</ParamField>

<ParamField body="metric_system" type="string">
  Updated measurement system preference.

  Available options: `metric`, `imperial`
</ParamField>

<ParamField body="preferences" type="object">
  Settings for billing, notifications, and reporting.

  <Expandable title="properties">
    <ParamField body="billing_cycle" type="string">
      Billing cycle preference (`monthly`, `weekly`, etc.).
    </ParamField>

    <ParamField body="default_currency" type="string">
      Preferred default currency code.
    </ParamField>

    <ParamField body="default_payment_method" type="string | null">
      ID of the default payment method used for billing.
    </ParamField>

    <ParamField body="notifications" type="boolean">
      Whether the account receives charging session notifications.
    </ParamField>

    <ParamField body="report_frequency" type="string">
      Frequency of scheduled reports.
    </ParamField>

    <ParamField body="reporting_enabled" type="boolean">
      Whether reporting is enabled for the account.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="status" type="string">
  Set operational status for the account.

  Available options: `active`, `suspended`, `archived`
</ParamField>

## Returns

Returns the updated account.