v1

latestOpenAPI 3.1.02026-08-0458234268.6 KB

vendors

Create a single new accounting vendor

Creates a new vendor with the provided details. The erp_vendor_id is required and will be mapped to both accounting_id and dd_unique_key.

post/vendors

Headers

Authorizationstring required

OAuth2 authentication flows. Auth server URLs will vary by environment

X-Api-Keystring required

API key for authentication

X-API-Versionstring

API version to use (optional, defaults to latest). Supported values: 1.0.0, 1.1.0.

Idempotency-Keystring

Client-generated unique key (UUID/ULID recommended). JSON requests: the first 2xx response is cached for 24h and replayed on a same-key retry with a matching body; a different body returns 422. Non-JSON requests (e.g. file uploads): the key is single-use — any same-key retry returns 422 regardless of body. See Idempotency for full details.

Request body

ottimate_company_idinteger required

erp_vendor_namestring required

erp_vendor_idstring required

emailstring

phonestring

net_termsstring

payment_method'credit_card' | 'ach' | 'check' | 'wire_transfer' | 'unknown'

(Optional) Vendor payment method

citystring

(Optional) Vendor city

statestring

(Optional) Vendor state

zipcodestring

(Optional) Vendor zipcode

address_line_1string

(Optional) Vendor address line 1

address_line_2string

(Optional) Vendor address line 2

Response

Successfully created

versionstring required