Skip to main content
PUT
/
v1
/
customers
/
{customerId}
Update Customer
curl --request PUT \
  --url https://{cluster}.voucherify.io/v1/customers/{customerId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>' \
  --data '{
  "name": "Alice McDonald",
  "email": "alice.mdconald@email.com",
  "description": "Updating customer data",
  "phone": "+1 (132) 222-2222",
  "address": {
    "city": "New York",
    "country": "United States",
    "line_1": "123 Main St.",
    "line_2": "APT 3 BLG 4",
    "postal_code": "10001",
    "state": "NY"
  },
  "metadata": {
    "lang": "en",
    "test": true
  },
  "birthdate": "2022-01-01",
  "birthday": "2022-01-02"
}'
{
  "id": "cust_T849EgzNVVmn5icJ2FAkT2rO",
  "source_id": "alice@morgan.com",
  "name": "Alice McDonald",
  "description": "Updating customer data",
  "email": "alice.mdconald@email.com",
  "phone": "+1 (132) 222-2222",
  "birthday": "2022-01-02",
  "birthdate": "2022-01-01",
  "address": {
    "city": "New York",
    "state": "NY",
    "line_1": "123 Main St.",
    "line_2": "APT 3 BLG 4",
    "country": "United States",
    "postal_code": "10001"
  },
  "summary": {
    "redemptions": {
      "total_redeemed": 2,
      "total_failed": 0,
      "total_succeeded": 2,
      "total_rolled_back": 0,
      "total_rollback_failed": 0,
      "total_rollback_succeeded": 0,
      "gift": {
        "redeemed_amount": 0,
        "amount_to_go": 0
      },
      "loyalty_card": {
        "redeemed_points": 0,
        "points_to_go": 4428
      }
    },
    "orders": {
      "total_amount": 203900,
      "total_count": 2,
      "average_amount": 101950,
      "last_order_amount": 3900,
      "last_order_date": "2022-07-26T14:59:52.814Z"
    }
  },
  "loyalty": {
    "points": 3403,
    "referred_customers": 0,
    "campaigns": {
      "Summer Campaign": {
        "points": 0,
        "referred_customers": 0
      },
      "Spring Campaign": {
        "points": 50,
        "referred_customers": 0
      },
      "Fall Campaign": {
        "points": 50,
        "referred_customers": 0
      },
      "Winter Campaign": {
        "points": 3303,
        "referred_customers": 0
      }
    }
  },
  "referrals": {
    "total": 0,
    "campaigns": []
  },
  "metadata": {
    "lang": "en",
    "test": true
  },
  "system_metadata": {},
  "created_at": "2022-02-07T08:28:23.644Z",
  "updated_at": "2022-08-31T09:58:30.475Z",
  "object": "customer"
}

Authorizations

​
X-App-Id
string
header
required
​
X-App-Token
string
header
required
​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
customerId
string
required

A Voucherify customer's id or source_id.

Example:

"cust_nk0N1uNQ1YnupAoJGOgvsODC"

Body

application/json

Specify the parameters to be updated.

Request body schema for PUT v1/customers/{customerId}.

​
name
string

Customer's first and last name.

​
description
string

An arbitrary string that you can attach to a customer object.

​
email
string

Customer's email address.

​
phone
string

Customer's phone number. This parameter is mandatory when you try to send out codes to customers via an SMS channel.

​
birthday
string<date>

Deprecated. Customer's birthdate; format YYYY-MM-DD.

​
birthdate
string<date>

Customer's birthdate; format YYYY-MM-DD.

​
address
object | null

Customer's address.

​
metadata
object

A set of custom key/value pairs that you can attach to a customer. The metadata object stores all custom attributes assigned to the customer. It can be useful for storing additional information about the customer in a structured format. This metadata can be used for validating whether the customer qualifies for a discount or it can be used in building customer segments.

Response

Returns a customer object if updates were successful.

Response body schema for PUT v1/customers/{customerId}.

​
summary
object
required
​
loyalty
object
required
​
referrals
object
required

Summary of customer's referrals, in this case, the customer being the referee, i.e. information about the source of referrals and number of times the customer was referred by other customers.

​
object
enum<string>
default:customer
required

The type of the object represented by JSON.

Available options:
customer
​
id
string

The ID of an existing customer that will be linked to redemption in this request.

​
source_id
string

A unique identifier of the customer who validates a voucher. It can be a customer ID or email from a CRM system, database, or a third-party service. If you also pass a customer ID (unique ID assigned by Voucherify), the source ID will be ignored.

​
system_metadata
object

Object used to store system metadata information.

​
created_at
string<date-time>

Timestamp representing the date and time when the customer was created. The value is shown in the ISO 8601 format.

Example:

"2022-08-30T06:32:07.380Z"

​
updated_at
string<date-time>

Timestamp representing the date and time when the customer was updated. The value is shown in the ISO 8601 format.

Example:

"2022-08-31T06:32:07.380Z"

​
assets
object

Contains information about the customer's cockpit.

​
name
string

Customer's first and last name.

​
description
string

An arbitrary string that you can attach to a customer object.

​
email
string

Customer's email address.

​
phone
string

Customer's phone number. This parameter is mandatory when you try to send out codes to customers via an SMS channel.

​
birthday
string<date>

Deprecated. Customer's birthdate; format YYYY-MM-DD.

​
birthdate
string<date>

Customer's birthdate; format YYYY-MM-DD.

​
address
object | null

Customer's address.

​
metadata
object

A set of custom key/value pairs that you can attach to a customer. The metadata object stores all custom attributes assigned to the customer. It can be useful for storing additional information about the customer in a structured format. This metadata can be used for validating whether the customer qualifies for a discount or it can be used in building customer segments.

⌘I