# Create a supplier

POST https://api.oletapp.com/your-store/v1/suppliers

Accepts every field the admin create form accepts, including billing/shipping contacts and `default_markup` (basis points). Duplicate names are allowed.

**Requires scope:** `catalog:write`

Required scope: `catalog:write`

## Parameters

None.

## Request body

```
{
  billing_address_1?: string | null
  billing_address_2?: string | null
  billing_city?: string | null
  billing_country?: string | null
  billing_email?: string | null
  billing_fax?: string | null
  billing_first_name?: string | null
  billing_last_name?: string | null
  billing_phone?: string | null
  billing_state?: string | null
  billing_zipcode?: string | null
  default_markup?: number | null
  description?: string | null
  name: string
  shipping_address_1?: string | null
  shipping_address_2?: string | null
  shipping_city?: string | null
  shipping_country?: string | null
  shipping_email?: string | null
  shipping_fax?: string | null
  shipping_first_name?: string | null
  shipping_last_name?: string | null
  shipping_phone?: string | null
  shipping_state?: string | null
  shipping_zipcode?: string | null
}
```

## Response (201)

```
{
  data: {
  billing_address_1: string | null
  billing_address_2: string | null
  billing_city: string | null
  billing_country: string | null
  billing_email: string | null
  billing_fax: string | null
  billing_first_name: string | null
  billing_last_name: string | null
  billing_phone: string | null
  billing_state: string | null
  billing_zipcode: string | null
  created_at: string
  default_markup: integer | null
  description: string | null
  id: string
  name: string
  shipping_address_1: string | null
  shipping_address_2: string | null
  shipping_city: string | null
  shipping_country: string | null
  shipping_email: string | null
  shipping_fax: string | null
  shipping_first_name: string | null
  shipping_last_name: string | null
  shipping_phone: string | null
  shipping_state: string | null
  shipping_zipcode: string | null
  updated_at: string
  version: string
}
}
```

Errors follow the standard error envelope: https://getolet.com/resources/developers/errors.md

## Example

```bash
curl -X POST "https://api.oletapp.com/your-store/v1/suppliers" \
  -H "Authorization: Bearer olet_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"string"}'
```