---
title: "Create vendor · Vendors · Practice Manager API · COUNT Partner API"
description: "Creates a new vendor in the workspace. POST /firm-partners/workspace/vendors"
canonical: "https://developers.getcount.com/practice-manager/reference/vendors/create-vendor"
source: "https://developers.getcount.com/practice-manager/reference/vendors/create-vendor"
---
[Vendors](https://developers.getcount.com/practice-manager/reference/vendors) / Create vendor

# Create vendor

POST `/firm-partners/workspace/vendors`

Creates a new vendor in the workspace.

Only `name` is required. Address and contacts can be created inline.

HMAC signature only

#### Headers

`count-workspace-id` uuid required

UUID of the client workspace to act on. It must be one of your firm's client workspaces (or the firm's own workspace) and within the API key's client workspaces.

#### Request body

`name` string required

Vendor display name.

`email` string

Primary email address.

`mainPhone` string

Primary phone number.

`website` string

Website URL.

`accountNumber` string

Your vendor account number.

`status` enum

Vendor status. Defaults to active.

One of: `active`, `inactive`

`type` enum

Vendor classification. Defaults to MERCHANT.

One of: `MERCHANT`, `SUPPLIER`, `CONTRACTOR`, `CONTACT`, `OWNER`

`legalName` string

Legal entity name.

`businessName` string

Doing-business-as name.

`taxNumber` string

Tax identification number.

`taxType` enum

Tax id type.

One of: `none`, `ssn`, `ein`, `itin`, `atin`

`is1099` boolean

Whether the vendor is a 1099 contractor.

`addToContractorGroup` boolean

Add vendor to the contractor group.

`address` object

Mailing address for the vendor.

`street` string

Street address.

`city` string

City or locality.

`state` string

State, province, or region.

`zipCode` string

Postal or ZIP code.

`country` string

Country name or ISO code.

`contacts` array

Contact people for this vendor.

`firstName` string

Contact's first name.

`lastName` string

Contact's last name.

`email` string

Contact's email address.

`phone` string

Contact's phone number.

`isPrimary` boolean

Marks the primary contact.

#### Responses

`201` Vendor created successfully.

`400` Validation failed or an active vendor with the same name already exists.

`401` Missing signing headers, an invalid HMAC signature, or a timestamp more than 5 minutes off. [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

`403` The key is inactive or its scope does not allow this request, the workspace is not managed by your firm or is outside the key's client workspaces, the workspace has no active subscription, or it is portal-only and the route needs bookkeeping. [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

`404` No workspace exists with the `count-workspace-id` UUID.

`429` Rate limit exceeded (100 requests per minute per firm user of each app, or 10,000 per minute per app). [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

[Previous GET List vendors](https://developers.getcount.com/practice-manager/reference/vendors/list-vendors) [Next PATCH Update vendor](https://developers.getcount.com/practice-manager/reference/vendors/update-vendor)

POST `https://api.getcount.com/firm-partners/workspace/vendors`

Request

```javascript
import crypto from 'node:crypto';

const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;

const method = 'POST';
const signingPath = '/workspace/vendors';
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = {
  "name": "Office Depot",
  "email": "ap@officedepot.com",
  "type": "SUPPLIER",
  "status": "active",
  "address": {
    "street": "500 Supply Chain Blvd",
    "city": "Boca Raton",
    "state": "FL",
    "zipCode": "33431",
    "country": "USA"
  }
};
const bodyString = JSON.stringify(body);

const bodyHash = crypto.createHash('sha256').update(bodyString).digest('hex');
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');

const response = await fetch(`${BASE_URL}/firm-partners/workspace/vendors`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
    'Content-Type': 'application/json',
    'count-workspace-id': '5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716',
  },
  body: bodyString,
});

console.log(await response.json());
```

Response · 201

```json
{
  "status": "success",
  "message": "Success on creating vendor.",
  "data": {
    "vendor": {
      "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
      "name": "Office Depot",
      "email": "ap@officedepot.com",
      "mainPhone": "+18001234567",
      "website": "https://officedepot.com",
      "accountNumber": "V-1001",
      "status": "active",
      "type": "SUPPLIER",
      "legalName": "Office Depot Inc.",
      "businessName": null,
      "taxNumber": null,
      "taxType": "none",
      "is1099": false,
      "address": {
        "street": "500 Supply Chain Blvd",
        "city": "Boca Raton",
        "state": "FL",
        "zipCode": "33431",
        "country": "USA"
      },
      "contacts": [
        {
          "id": "a5da3577-bf85-4e3a-aa73-df85ca69bc67",
          "firstName": "Accounts",
          "lastName": "Payable",
          "email": "ap@officedepot.com",
          "phone": "+18001234567",
          "isPrimary": true
        }
      ],
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedAt": "2026-01-28T14:22:30.000Z"
    }
  }
}
```
