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

# Crear un proveedor

> Crea un nuevo proveedor para el vendor.

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

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

<ParamField body="name" type="string" required>Nombre del proveedor.</ParamField>
<ParamField body="external_supplier_id" type="string">Identificador en tu sistema.</ParamField>
<ParamField body="metadata" type="object">Datos adicionales libres.</ParamField>
<ParamField body="external_user_id" type="string">Actor para auditoría.</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "name": "Proveedor Fresco S.A.",
    "external_supplier_id": "proveedor-fresco",
    "external_user_id": "usuario_admin_01"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "sup_01j5k...",
    "account_id": "acc_01j5k...",
    "name": "Proveedor Fresco S.A.",
    "external_supplier_id": "proveedor-fresco",
    "status": "ACTIVE",
    "metadata": {}
  }
  ```
</ResponseExample>