## Create D1 Database

**post** `/accounts/{account_id}/d1/database`

Returns the created D1 database.

### Path Parameters

- `account_id: string`

  Account identifier tag.

### Body Parameters

- `name: string`

  D1 database name.

- `jurisdiction: optional "eu" or "fedramp"`

  Specify the location to restrict the D1 database to run and store data. If this option is present, the location hint is ignored.

  - `"eu"`

  - `"fedramp"`

- `primary_location_hint: optional "wnam" or "enam" or "weur" or 3 more`

  Specify the region to create the D1 primary, if available. If this option is omitted, the D1 will be created as close as possible to the current user.

  - `"wnam"`

  - `"enam"`

  - `"weur"`

  - `"eeur"`

  - `"apac"`

  - `"oc"`

### Returns

- `errors: array of ResponseInfo`

  - `code: number`

  - `message: string`

  - `documentation_url: optional string`

  - `source: optional object { pointer }`

    - `pointer: optional string`

- `messages: array of ResponseInfo`

  - `code: number`

  - `message: string`

  - `documentation_url: optional string`

  - `source: optional object { pointer }`

- `result: D1`

  The details of the D1 database.

  - `created_at: optional string`

    Specifies the timestamp the resource was created as an ISO8601 string.

  - `file_size: optional number`

    The D1 database's size, in bytes.

  - `jurisdiction: optional "eu" or "fedramp"`

    Specify the location to restrict the D1 database to run and store data. If this option is present, the location hint is ignored.

    - `"eu"`

    - `"fedramp"`

  - `name: optional string`

    D1 database name.

  - `num_tables: optional number`

  - `read_replication: optional object { mode }`

    Configuration for D1 read replication.

    - `mode: "auto" or "disabled"`

      The read replication mode for the database. Use 'auto' to create replicas and allow D1 automatically place them around the world, or 'disabled' to not use any database replicas (it can take a few hours for all replicas to be deleted).

      - `"auto"`

      - `"disabled"`

  - `uuid: optional string`

    D1 database identifier (UUID).

  - `version: optional string`

- `success: true`

  Whether the API call was successful

  - `true`

### Example

```http
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/d1/database \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
    -d '{
          "name": "my-database",
          "jurisdiction": "eu",
          "primary_location_hint": "wnam"
        }'
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "created_at": "2022-11-15T18:25:44.442097Z",
    "file_size": 12,
    "jurisdiction": "eu",
    "name": "my-database",
    "num_tables": 12,
    "read_replication": {
      "mode": "auto"
    },
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "version": "production"
  },
  "success": true
}
```