Skip to main content
PUT
/
v1
/
customers
/
{key}
Update customer
curl --request PUT \
  --url https://api.example.com/v1/customers/{key}
{
  "data": {
    "key": "customer_123",
    "partner": "partner_123",
    "deleted": false,
    "name": "Amanda",
    "surname": "Green",
    "email": "[email protected]",
    "status": "active",
    "created_at": "2025-05-02T16:12:39.000000Z",
    "updated_at": "2025-05-02T18:45:22.000000Z",
    "deleted_at": null,
    "tags": [
      {
        "value": "premium"
      },
      {
        "value": "vip"
      }
    ]
  },
  "status": 1
}

Endpoint

PUT https://api.partnero.com/v1/customers/{key}

Parameters

You can identify the customer either by path parameter or request body:
ParameterLocationTypeDescription
keypathstringCustomer’s unique key in the URL
keybodystringCustomer’s key (alternative to path)

Request body

ParameterTypeRequiredDescription
updateobjectYesObject containing fields to update
update.emailstringNoNew email address
update.namestringNoCustomer’s first name
update.surnamestringNoCustomer’s last name
update.keystringNoNew customer key (must be unique)
update.tagsarrayNoTags to associate. Empty array [] removes all tags. null skips update

Request

curl --location --request PUT 'https://api.partnero.com/v1/customers/customer_123' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "update": {
      "name": "Amanda",
      "surname": "Green",
      "email": "[email protected]",
      "tags": ["premium", "vip"]
    }
  }'

Response

{
  "data": {
    "key": "customer_123",
    "partner": "partner_123",
    "deleted": false,
    "name": "Amanda",
    "surname": "Green",
    "email": "[email protected]",
    "status": "active",
    "created_at": "2025-05-02T16:12:39.000000Z",
    "updated_at": "2025-05-02T18:45:22.000000Z",
    "deleted_at": null,
    "tags": [
      {
        "value": "premium"
      },
      {
        "value": "vip"
      }
    ]
  },
  "status": 1
}