---
title: "Add a new supplier"
method: POST
path: "/api/create-supplier/"
tags: ["Supplier Management"]
---

# Add a new supplier

`POST /api/create-supplier/`

## Request

- Base URL: `https://api.auravms.com`
- URL: `https://api.auravms.com/api/create-supplier/`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `company_name` string, required
  - `person_of_contact` string, required
  - `phone_no` string, required
  - `email` string, email, required
  - `categories` string[]
  - `remark` string
  - `location` string: Optional city, e.g. "Pune". Matched case-insensitively against existing supplier locations and reuses their spelling.

## Response `200`

Supplier created; returns supplier_id

## Other responses

- `409`: Idempotency key is processing or was already used with a different request body

---

[API](https://skmtc.dev/auravms/apis/auravms-api.md) · [All operations](https://skmtc.dev/auravms/apis/auravms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/auravms/apis/auravms-api/revisions/794a4470e3af?raw)