> ## 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.

# Create a Fleet

Creates a fleet. Use fleets to group vehicles and drivers and to apply shared billing and reporting preferences.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.chargeapi.co/v1/fleets \
    -H "Authorization: Bearer ch_sk_test_..." \
    --json '{
    "name": "Example Fleet"
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
      "id": "flt_XcVhxA1qoU3AeQ62khcFJ2U8cM3YvnYJ",
      "object": "fleet",
      "address": {
          "city": "Paris",
          "country": "FR",
          "line1": "10 Rue de la Paix",
          "line2": "Batiment A",
          "postal_code": "75002",
          "state": "Ile-de-France"
      },
      "created": "2026-04-01T00:18:21.434Z",
      "description": null,
      "email": "example@example.com",
      "metadata": {},
      "metric_system": "international_system",
      "name": "Example Fleet",
      "phone": null,
      "policy_ids": [],
      "preferences": {
          "billing_cycle": "monthly",
          "default_currency": "eur",
          "default_payment_method": null,
          "notifications": true,
          "report_frequency": "weekly"
      },
      "status": "active",
      "timezone": "Europe/Paris",
      "total_drivers": 0,
      "total_energy_consumed_kwh": 0,
      "total_sessions": 0,
      "total_vehicles": 0,
      "updated": "2026-04-01T00:26:27.243Z",
      "wallet_balance": 0
  }
  ```
</ResponseExample>

## Parameters

<ParamField body="email" type="string">
  Optional contact email for fleet notifications.
</ParamField>

<ParamField body="name" type="string" required>
  Human-readable name for the fleet.
</ParamField>

<ParamField body="timezone" type="string">
  IANA timezone.
</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">
  Preferred unit system for reports.

  Available options: `international_system`, `us_customary_system`, `imperial_system`
</ParamField>

<ParamField body="preferences" type="object">
  Account-level settings related to billing, reporting, and charging activity.

  <Expandable title="properties">
    <ParamField body="billing_cycle" type="string">
      Frequency of billing for the fleet (`monthly`, `weekly`, etc.).
    </ParamField>

    <ParamField body="default_currency" type="string">
      Preferred currency for cost estimates and billing.
    </ParamField>

    <ParamField body="default_payment_method" type="string">
      ID of the default payment method to use for charging sessions.
    </ParamField>

    <ParamField body="notifications" type="boolean">
      Whether drivers in this fleet receive session status notifications.
    </ParamField>

    <ParamField body="report_frequency" type="string">
      Frequency of automated report delivery (`weekly`, `monthly`, etc.).
    </ParamField>
  </Expandable>
</ParamField>

## Returns

Returns the created fleet.