Skip to main content
PATCH
/
partner
/
users
/
:id
curl https://api.thanxsandbox.com/partner/users/:id?merchant_id=owierywtwt \
  -X PATCH \
  -H 'X-ClientId: {client_id}' \
  -H 'Accept-Version: v4.0' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {access_token}' \
  -d '{
    "user": {
      "email": "john.smith@example.com",
      "first_name": "Jane",
      "last_name": "Smith"
    }
  }'

{
  "user": {
    "id": "wroeiu2304hfwf",
    "email": "john.smith@example.com",
    "phone": "+14158672345",
    "first_name": "Jane",
    "last_name": "Smith",
    "birth_date": {
      "year": 1987,
      "month": 8,
      "day": 14
    },
    "zip_code": "12345",
    "updated_at": "2025-02-01T19:00:00Z",
    "loyalty": {
      "tier": "silver",
      "points_balance": 120.50,
      "user_joined_at": "2023-12-01T19:00:00Z"
    },
    "communication_settings": {
      "marketing_general_email": true
    }
  }
}
Scope required: users.write
The user’s phone number is not gathered by Thanx with the permission to use it for marketing.
To update a user’s notification / email settings, use Update User’s Communication Settings instead. communication_settings is read-only on this endpoint.

​
Parameters

​
id
string
required
User ID
​
merchant_id
string
required
Merchant ID

​
Body

​
email
string
The user’s email
​
phone
string
The user’s phone number in E.164 format, with the country code prefix (e.g. +14157582345). Phones submitted without the country code prefix are stored as-is — this endpoint does not normalize them — and will fail later phone-based lookups (such as Partner Auth Token) that depend on E.164 parsing.
​
first_name
string
The user’s first name
​
last_name
string
The user’s last name
​
birth_date
hash
The user’s birthday information
​
zip_code
string
The user’s zip code

​
Response

​
id
string
The user's identifier
​
email
string
The user's email
​
phone
string
The user's phone number, in E.164 format (eg. +14157582345)
​
first_name
string
The user's first name
​
last_name
string
The user's last name
​
birth_date
hash
The user's birthday information
​
zip_code
string
The user's zip code
​
updated_at
datetime
Datetime the user record was last updated.
​
loyalty
hash
​
communication_settings
hash
curl https://api.thanxsandbox.com/partner/users/:id?merchant_id=owierywtwt \
  -X PATCH \
  -H 'X-ClientId: {client_id}' \
  -H 'Accept-Version: v4.0' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {access_token}' \
  -d '{
    "user": {
      "email": "john.smith@example.com",
      "first_name": "Jane",
      "last_name": "Smith"
    }
  }'

{
  "user": {
    "id": "wroeiu2304hfwf",
    "email": "john.smith@example.com",
    "phone": "+14158672345",
    "first_name": "Jane",
    "last_name": "Smith",
    "birth_date": {
      "year": 1987,
      "month": 8,
      "day": 14
    },
    "zip_code": "12345",
    "updated_at": "2025-02-01T19:00:00Z",
    "loyalty": {
      "tier": "silver",
      "points_balance": 120.50,
      "user_joined_at": "2023-12-01T19:00:00Z"
    },
    "communication_settings": {
      "marketing_general_email": true
    }
  }
}