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

# Create a store

> Creates a new store (physical location) for the vendor.

<ParamField header="x-api-key" type="string" required>
  BOH API key with `catalog:write` scope.
</ParamField>

<ParamField path="vendorId" type="string" required>
  Vendor UUID.
</ParamField>

<ParamField body="name" type="string" required>
  Display name (max 200 characters).
</ParamField>

<ParamField body="timezone" type="string" required>
  IANA timezone identifier (e.g. `America/Mexico_City`).
</ParamField>

<ParamField body="code" type="string">
  Short alphanumeric code.
</ParamField>

<ParamField body="external_store_id" type="string">
  Your system's store identifier. Used in operation payloads instead of UUID.
</ParamField>

<ParamField body="tax_id" type="string">
  Fiscal identifier of the store (RUC, CNPJ, CUIT, NIT, RUT, RFC, or any country-specific alphanumeric code, max 64 chars). Optional and not unique — in some countries all stores of a company share the same value. Used to resolve the store in purchase orders via `store_tax_id`. Set to `null` to clear.
</ParamField>

<ParamField body="metadata" type="object">
  Free-form extra data.
</ParamField>

<ParamField body="external_user_id" type="string">
  Actor for audit trail.
</ParamField>

<ResponseField name="id" type="string">Store UUID.</ResponseField>
<ResponseField name="account_id" type="string">Account UUID.</ResponseField>
<ResponseField name="code" type="string">Short alphanumeric code.</ResponseField>
<ResponseField name="name" type="string">Display name.</ResponseField>
<ResponseField name="timezone" type="string">IANA timezone identifier.</ResponseField>
<ResponseField name="status" type="string">`ACTIVE` by default.</ResponseField>
<ResponseField name="external_store_id" type="string">Your system's store identifier.</ResponseField>
<ResponseField name="tax_id" type="string">Fiscal identifier of the store.</ResponseField>

<RequestExample>
  ```json theme={null}
  {
    "name": "Main Kitchen",
    "timezone": "America/Mexico_City",
    "code": "STR-001",
    "external_store_id": "store-main",
    "external_user_id": "user_admin_01"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "str_main_01...",
    "account_id": "acc_01j5k...",
    "code": "STR-001",
    "name": "Main Kitchen",
    "timezone": "America/Mexico_City",
    "status": "ACTIVE",
    "external_store_id": "store-main",
    "tax_id": null,
    "metadata": {},
    "created_at": "2026-08-07T14:30:00.000Z",
    "updated_at": "2026-08-07T14:30:00.000Z"
  }
  ```

  ```json 400 theme={null}
  {
    "error": {
      "kind": "validation_error",
      "message": "timezone is required"
    }
  }
  ```
</ResponseExample>