Ramp: Update a vendor — vendor patch Vendor Resource — request body — body

API reference · Contract 2026-10-27

SDK schema: Update a vendor — vendor patch Vendor Resource — request body — body

Field	Type	Presence	Description and constraints
$	object	Root
accounting_vendor_remote_id	string	Optional	The accounting remote id of the vendor. At most one of `accounting_vendor_remote_id` or `vendor_tracking_category_option_id` should be provided.
address	Model	Optional	Expand Create a new vendor — request body — body address The address of the vendor.
country	string	Optional	The country of the vendor.
default_bank_account_id	string	Optional	Unique identifier of an existing bank account belonging to this vendor to use as its default payment method. The account determines the payment method. Existing bills are not changed. Omit to leave the default unchanged. Format: uuid
default_entity_id	JSON	Optional
default_entity_id (anyOf 1)	string	Alternative	Unique identifier of the default business entity to associate with this vendor. Must belong to the current business. Set to null to clear the default entity. Format: uuid
default_entity_id (anyOf 2)	null	Alternative
description	string	Optional	Description of the vendor.
external_vendor_id	JSON	Optional
external_vendor_id (anyOf 1)	string	Alternative	Customer-defined external identifier for the vendor. This is independent of accounting system remote IDs.
external_vendor_id (anyOf 2)	null	Alternative
is_active	boolean	Optional	Whether this vendor is active.
name	string	Optional	Name of the vendor. Minimum length: 1
net_payment_terms	JSON	Optional
net_payment_terms (anyOf 1)	integer	Alternative	Number of days after receipt that payment is due. 0 means due on receipt; null clears the terms. Omit to leave unchanged. Maximum: 3652058 Minimum: 0
net_payment_terms (anyOf 2)	null	Alternative
request_payment_details	boolean	Optional	Whether to request payment details from the vendor (ACH bank account, international wire transfer, and check mailing address). Requires an existing default vendor contact email. Default: false
request_tax_details	boolean	Optional	Whether to request tax information from the vendor (Tax Identification Number, federal tax classification, and tax address). Requires an existing default vendor contact email. Default: false
state	JSON	Optional
state (anyOf 1)	string	Alternative	Vendor-level two-letter US state abbreviation, such as VA. Required when the vendor country is US. Ignored for non-US vendor countries. Default: null
state (anyOf 2)	null	Alternative
vendor_tracking_category_option_id	string	Optional	Unique identifier of the vendor. At most one of `accounting_vendor_remote_id` or `vendor_tracking_category_option_id` should be provided. Format: uuid

Referenced models: Create a new vendor — request body — body address