Update vendor

Custom dictionary of key:value pairs. You can use this field to store any data related to the object or for your system. If you are using custom identifiers, pass those in this object. Max length for a value is 100 characters. Example usage:

1
{
2
  "additionalData": {
3
    "key1": "value1",
4
    "key2": "value2",
5
    "key3": "value3"
6
  }
7
}

Vendor’s street address. If any address field is provided, this field is required along with city, state, and zip. Allowed characters are letters, numbers, spaces, and `. ,

Vendor’s country. Must be US or CA. Defaults to US if not provided.

EIN/Tax ID for vendor. Must be nine digits formatted as XX-XXXXXXX (for example, 12-3456789).

Business Merchant Category Code (MCC). This resource lists MCC codes.

Primary name for vendor. Required for new vendor. Allowed characters are letters, numbers, spaces, and the following symbols `. , ’ & ( )

Secondary name for vendor. If provided, allowed characters are the same as the name1 field. Letters, numbers, spaces, and `. , ’ & ( )

The vendor’s preferred payment method. Can be one of:

• "managed" - Managed payment method
• "vcard" - Virtual card payment method
• "check" - Check payment method
• "ach" - ACH payment method

Vendor’s phone number. Phone number can’t contain non-digit characters like hyphens or parentheses.

Remittance street address. Used for mailing paper checks. Required if any remittance address field is provided. Allowed characters are letters, numbers, spaces, and `. ,

Remittance address country. Used for mailing paper checks. Must be US or CA. Defaults to US if not provided.

Remittance address ZIP or postal code. Used for mailing paper checks. Required if any remittance address field is provided. For US addresses, use five digits or ZIP+4 format.

Vendor’s state or province. Required if any address field is provided. Must be a valid US state abbreviation (such as CA, NY) or Canadian province abbreviation (such as ON, BC), depending on the country value.

Vendor’s status. Allowed values:

• 0 Inactive

• 1 Active

• -99 Deleted

Vendor’s ZIP or postal code. Required if any address field is provided. For US addresses, use five digits (12345) or ZIP+4 format (12345-6789).

PDF invoice attachment for AI-powered vendor enrichment. When this feature is enabled and you include an attachment, the invoice is scanned and extracted vendor information is merged into the request. Fields in the request body take precedence over extracted data. If the scan fails, vendor creation proceeds with the original request data.

See the vendor enrichment guide for details. Contact Payabli to enable this feature.