Skip to main content
PUT
/
v2
/
vendor
/
address
Update Address
curl --request PUT \
  --url https://api.puppetvendors.com/v2/vendor/address \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "address1": "<string>",
  "address2": "<string>",
  "city": "<string>",
  "state": "<string>",
  "country": "<string>",
  "zip": "<string>",
  "phone": "<string>"
}
'
V2 Alpha — This endpoint is part of the V2 API preview. Breaking changes may occur.

​
Overview

Update the business address for the authenticated vendor. All fields are optional — only fields included in the request body are updated.
Vendor Token Required — This endpoint requires a vendor-scoped JWT token. Merchant tokens will receive a 403 error.

​
Use Cases

  • Allow vendors to update their address from a self-service portal
  • Sync address changes from an external system

​
Request Body

​
address1
string
Address line 1 (max 500 characters).
​
address2
string
Address line 2 (max 500 characters).
​
city
string
City name (max 200 characters).
​
state
string
State or province (max 200 characters).
​
country
string
Country name (max 200 characters).
​
zip
string
Postal / ZIP code (max 50 characters).
​
phone
string
Phone number (max 50 characters).

​
Response

200
{
  "success": true,
  "data": {
    "address1": "456 New Street",
    "address2": "Suite 10",
    "city": "Manchester",
    "state": "England",
    "country": "United Kingdom",
    "zip": "M1 1AA",
    "phone": "+44-161-123-4567"
  }
}

​
Error Responses

400
{
  "success": false,
  "error": "Validation failed",
  "details": [
    {
      "path": ["address1"],
      "message": "String must contain at most 500 character(s)"
    }
  ]
}
404
{
  "success": false,
  "error": "Vendor not found"
}

​
Example

curl -X PUT "https://api.puppetvendors.com/v2/vendor/address" \
  -H "Content-Type: application/json" \
  -H "x-access-token: YOUR_VENDOR_JWT_TOKEN" \
  -d '{
    "address1": "456 New Street",
    "address2": "Suite 10",
    "city": "Manchester",
    "state": "England",
    "country": "United Kingdom",
    "zip": "M1 1AA",
    "phone": "+44-161-123-4567"
  }'