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

# Create a vendor

`POST /v1/vendors`

## Request

- Base URL: `https://api.navigateai.co`
- URL: `https://api.navigateai.co/v1/vendors`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/navigateai/apis/navigateai-api/docs/v1/vendors/post.ts> (a function with typed inputs; its response is checked against the schema)

## 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.dev/navigateai/apis/navigateai-api.md) - [All operations](https://skmtc.dev/navigateai/apis/navigateai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/navigateai/apis/navigateai-api/revisions/912b48581de7?raw)