---
title: "Create a vendor"
method: POST
path: "/v1/vendors"
tags: ["Vendors"]
---

# Create a vendor

`POST /v1/vendors`

## Request body

- CreateVendorOrganizationRequest
  - `name` string, required
  - `email` string, nullable
  - `reference_key` string, required
  - `market_ids` string[] — IDs of the markets this vendor serves. A vendor with no market associations (empty list) serves all markets. May be omitted (defaults to empty list).

## Response `201`

Created

- VendorOrganizationResponse
  - `vendor` VendorOrganizationExternalSchema, required
    - `id` string, required
    - `name` string, required
    - `email` string, nullable, required
    - `reference_key` string, required — Optional unique identifier for this vendor in your system.
    - `is_enabled` boolean, required — Whether this vendor is enabled.
    - `market_ids` string[], required — IDs of the markets this vendor serves. A vendor with no market associations serves all markets.

---

[API](https://skmtc.net/navigateai/apis/navigateai-api.md) · [All operations](https://skmtc.net/navigateai/apis/navigateai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/navigateai/navigateai-api/revisions/5fb236d03a88/schema)