Update customer

Update an existing customer’s details or tags in your affiliate program

PUT /v1/customers/{key}

Update customer

cURL

curl --request PUT \
  --url https://api.example.com/v1/customers/{key}

200 OK

{
  "data": {
    "key": "customer_123",
    "partner": "partner_123",
    "deleted": false,
    "name": "Amanda",
    "surname": "Green",
    "email": "[e-mail]",
    "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:

Parameter	Location	Type	Description
key	path	string	Customer’s unique key in the URL
key	body	string	Customer’s key (alternative to path)

Request body

Parameter	Type	Required	Description
update	object	Yes	Object containing fields to update
update.email	string	No	New email address
update.name	string	No	Customer’s first name
update.surname	string	No	Customer’s last name
update.key	string	No	New customer key (must be unique)
update.tags	array	No	Tags to associate. Empty array [] removes all tags. null skips update

Request

cURL (by path)

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": "[e-mail]",
      "tags": ["premium", "vip"]
    }
  }'

Response

200 OK

{
  "data": {
    "key": "customer_123",
    "partner": "partner_123",
    "deleted": false,
    "name": "Amanda",
    "surname": "Green",
    "email": "[e-mail]",
    "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
}