Vendors

Create vendor

Changed on

Create a new vendor record with address and payment information.

post/public/v2/vendors/

Request

  • Base URL: https://api.dualentry.com
  • URL: https://api.dualentry.com/public/v2/vendors/
  • Auth: none declared

Headers

Idempotency-Keystring

Optional. A unique value (a UUID works well) identifying this operation. If the request is repeated with the same key, the original response is replayed instead of the operation running again, so a retry cannot create a duplicate record. Results are replayable for 48 hours. Reusing a key with a different request body returns 422.

Request body

custom_fieldsobject[] nullable
is_activeboolean required
vendor_type'individual' | 'company' | 'intercompany' | 'tax_agency' required
namestring required
unique_idstring nullable
emailstring required
phonestring required
websitestring required
single_addressstring nullable
is_1099_eligibleboolean
tinstring nullable
tin_type'ein' | 'ssn' | 'utr'
record_status'draft' | 'posted' | 'archived'
term_idinteger nullable
customer_account_numberstring
name_on_checkstring
preferred_payment_method_idinteger nullable
bank_account_numberstring
bank_routing_numberstring
default_expense_account_idinteger nullable
allowed_company_idsinteger[] nullable

Company IDs allowed to use this vendor. Empty list means global (all companies).

classification_line_idsinteger[] nullable

Classification lines stored on this record.

Response

Created

classification_line_idsinteger[]
created_atstring date-time required
updated_atstring date-time required
term_idinteger nullable required
term_namestring required
preferred_payment_method_idinteger nullable required
preferred_payment_method_namestring required
approval_statusstring nullable
idinteger required
codestring nullable
vendor_typestring required
company_idinteger nullable
company_namestring nullable
customer_account_numberstring
name_on_checkstring
bank_account_numberstring
bank_routing_numberstring
default_expense_account_idinteger nullable
allowed_company_idsinteger[]
merged_into_idinteger nullable

The ID of the surviving vendor when this vendor was merged into another vendor.

single_addressstring nullable
namestring required
unique_idstring nullable

External identifier supplied by the user to disambiguate vendors that share a display name (e.g. an ID from another system).

websitestring nullable
emailstring nullable
is_activeboolean
phonestring nullable
is_1099_eligibleboolean
tinstring nullable
tin_typestring nullable
record_status'draft' | 'posted' | 'archived'

Changes