curl --request PUT \
--url {protocol}://{host}/v2/loyalties/programs/{programId}/members/{memberId} \
--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
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
Path Parameters
Unique 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.
^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?