# Create or update a vendor

A vendor is identified by its vendor identifier. If a vendor is found the vendor is updated with the provided data. If a vendor is not found, a new one is created.

Endpoint: POST /vendor_updates
Version: 2.0.0
Security: oAuth2

## Request fields (application/json):

  - `vendor_update` (object)

  - `vendor_update.name` (string, required)
    Example: "Abc Vendors"

  - `vendor_update.vendor_identifier` (string, required)
    Example: "abc-vendors"

  - `vendor_update.client_identifier` (string, required)
    Example: 123

  - `vendor_update.eligibility` (string)
    Enum: "forced", "eligible", "prohibited"

  - `vendor_update.additional_policy` (string)
    Enum: "null", "vendor_allowance", "debit_and_destroy"

  - `vendor_update.notes` (string)
    Example: "Only accepts shipments on Tuesdays."

  - `vendor_update.manufacturer_name` (string)
    Example: "ABC Vendors Inc."

  - `vendor_update.billing_info` (string)
    Example: "credit"

  - `vendor_update.vendor_contact` (object)

  - `vendor_update.vendor_contact.email` (string)
    Example: "abcvendors@gmail.com"

  - `vendor_update.vendor_contact.phone` (string)
    Example: "2234842321"

  - `vendor_update.shipping_address` (object)

  - `vendor_update.shipping_address.address_1` (string)
    Example: "444 Mayflower St"

  - `vendor_update.shipping_address.address_2` (string)
    Example: "Apt 422"

  - `vendor_update.shipping_address.address_3` (string)
    Example: "PO 1"

  - `vendor_update.shipping_address.city` (string)
    Example: "Lake Winnipeg"

  - `vendor_update.shipping_address.state` (string)
    Example: "IL"

  - `vendor_update.shipping_address.country` (string)
    Example: "US"

  - `vendor_update.shipping_address.postal_code` (string)
    Example: "60660"

  - `vendor_update.web_portal_url` (string)
    Example: "http://abcvendors.com"

  - `vendor_update.payment_option` (string)
    Enum: "prepaid", "collect", "third-party-billing"

  - `vendor_update.open_ra_number` (object)

  - `vendor_update.open_ra_number.type` (string)
    Enum: "static", "generated"

  - `vendor_update.open_ra_number.value` (string)
    Example: "134"

  - `vendor_update.handling_instructions` (string)
    Deprecated: use notes field instead
    Example: "Handled with the utmost care."

  - `vendor_update.expected_credit_percent` (string)
    Example: "12"

  - `vendor_update.requires_approval` (boolean)
    Example: true

## Response 201 fields (application/json):

  - `id` (number)
    Example: 12

## Response 202 fields (application/json):

  - `id` (number)
    Example: 12


## Response 400 fields

## Response 500 fields

## Response 502 fields

## Response 503 fields

## Response 504 fields