curl --request PUT \
--url {protocol}://{host}/v2/loyalties/programs/{programId}/members/{memberId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-App-Id: <api-key>' \
--header 'X-App-Token: <api-key>' \
--data '{
"metadata": {}
}'{
"id": "lmbr_128f962dbc8c4ba5dc",
"customer_id": "cust_6onRrs4kCnvSVrTs5YtDPFBG",
"program_id": "lprg_128f58429f4c4bf7b2",
"status": "ACTIVE",
"metadata": {
"tier_note": "gold",
"source": "crm"
},
"created_at": "2026-06-11T15:59:41.298Z",
"updated_at": "2026-07-30T10:15:22.401Z",
"object": "member"
}Update program member
This is a work-in-progress documentation of a BETA endpoint. The parameters, fields, request and response bodies, and other data may subject to change. If you want to share feedback or improvements, contact Voucherify support or your Technical Account Manager.
Updates a program member’s metadata. Provided object keys are merged into the existing metadata; omitted keys are preserved. Pass metadata: null to clear all metadata (sets it to an empty object).
This endpoint cannot change status. Use Activate a program member or Deactivate a program member for status transitions.
Records a vl.member.updated activity. Returns the updated member without the cards array. Returns 404 when the program or member does not exist. Returns 400 when the request body fails validation or the project vl_member metadata schema rejects the payload.
A valid request URL is required to generate request examples{
"id": "lmbr_128f962dbc8c4ba5dc",
"customer_id": "cust_6onRrs4kCnvSVrTs5YtDPFBG",
"program_id": "lprg_128f58429f4c4bf7b2",
"status": "ACTIVE",
"metadata": {
"tier_note": "gold",
"source": "crm"
},
"created_at": "2026-06-11T15:59:41.298Z",
"updated_at": "2026-07-30T10:15:22.401Z",
"object": "member"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Loyalty program ID (format lprg_[a-f0-9]+).
^lprg_[a-f0-9]+$Program member ID (format lmbr_[a-f0-9]+).
^lmbr_[a-f0-9]+$Body
Request body for updating a program member. Only metadata is updatable. No additional properties are allowed.
Member metadata to apply. Object keys are merged into existing metadata (omitted keys are preserved). Validated against the vl_member metadata schema when configured. Pass null to clear all metadata.
Response
The updated member (without cards).
A loyalty program member.
Unique member ID assigned by Voucherify.
^lmbr_[a-f0-9]+$Unique Voucherify ID of the customer enrolled as this member.
^cust_[a-zA-Z0-9]+Unique Voucherify ID of the loyalty program the member belongs to.
^lprg_[a-f0-9]+$Current member status. INACTIVE member can't earn points or redeem rewards.
ACTIVE, INACTIVE, DELETED Free-form metadata attached to the member (empty object when none).
Timestamp when the member was created (ISO 8601).
Timestamp when the member was last updated (ISO 8601), or null if never updated.
Object type marker, always member.
"member"Was this page helpful?