Update vendorBeta

PUT

/v2/vendors/{vendor_id}

Updates an existing Vendor object as a supplier to a seller.

Permissions:VENDOR_WRITE

Guide

Update vendors

Try in API Explorer

Link to section

Request body

Example code

Link to section

idempotency_key

string

A client-supplied, universally unique identifier (UUID) for the request.

See Idempotency in the API Development 101 section for more information.

Max Length

128

Link to section

vendor

Required

The specified Vendor to be updated.

Link to section

Response fields

Link to section

errors

Errors occurred when the request fails.

Link to section

vendor

The Vendor that has been updated.

Link to section

Examples

All versions ->

PUT /v2/vendors/{vendor_id}

curl https://connect.squareup.com/v2/vendors/{vendor_id} \
  -X PUT \
  -H 'Square-Version: 2025-06-18' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "idempotency_key": "8fc6a5b0-9fe8-4b46-b46b-2ef95793abbe",
    "vendor": {
      "id": "INV_V_JDKYHBWT1D4F8MFH63DBMEN8Y4",
      "name": "Jack'\''s Chicken Shack",
      "status": "ACTIVE",
      "version": 1
    }
  }'

Response JSON

{
  "vendor": {
    "id": "INV_V_JDKYHBWT1D4F8MFH63DBMEN8Y4",
    "created_at": "2022-03-16T10:21:54.859Z",
    "updated_at": "2022-03-16T20:21:54.859Z",
    "name": "Jack's Chicken Shack",
    "address": {
      "address_line_1": "505 Electric Ave",
      "address_line_2": "Suite 600",
      "locality": "New York",
      "administrative_district_level_1": "NY",
      "postal_code": "10003",
      "country": "US"
    },
    "contacts": [
      {
        "id": "INV_VC_FMCYHBWT1TPL8MFH52PBMEN92A",
        "name": "Joe Burrow",
        "email_address": "[email protected]",
        "phone_number": "1-212-555-4250",
        "ordinal": 0
      }
    ],
    "account_number": "4025391",
    "version": 2,
    "status": "ACTIVE"
  }
}