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

# Create a vendor

`POST /vendors`

Create a new vendor with the provided information. Optionally include bank account details.

## Request body

- CreateVendorInput — Vendor creation request
  - `bank_account` BankAccountInput — Bank account details for vendor creation
    - `account_number` string
    - `account_type` string
    - `bank_name` string
    - `routing_number` string
  - `category` string
  - `city` string
  - `country` string
  - `email` string
  - `name` string
  - `phone` string
  - `postal_code` string
  - `state` string
  - `street_address` string
  - `tax_id` string

## Response `201`

Created

- VendorReply — Vendor details
  - `category` string
  - `city` string
  - `country` string
  - `created_at` string
  - `email` string
  - `id` string
  - `is_active` boolean
  - `name` string
  - `origin` 'manual' | 'quickbooks' | 'ocr' — Vendor origin enum
  - `phone` string
  - `postal_code` string
  - `state` string
  - `street_address` string
  - `tax_id` string
  - `updated_at` string

## Other responses

- `400` — Bad Request
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/alternativepayments/apis/alternative-payments.md) · [All operations](https://skmtc.net/alternativepayments/apis/alternative-payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alternativepayments/alternative-payments/revisions/730efda86cd1/schema)