Sign in

v18

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01934981.1 MB
Programs

Update program member

<Warning>

<Badge color="yellow">BETA endpoint</Badge>

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.

</Warning>

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.

put/v2/loyalties/programs/{programId}/members/{memberId}

Path parameters

programIdstring required

Loyalty program ID (format lprg_[a-f0-9]+).

memberIdstring required

Program member ID (format lmbr_[a-f0-9]+).

Request body

metadataobject nullable required

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).

idstring required

Unique member ID assigned by Voucherify.

customer_idstring required

Unique Voucherify ID of the customer enrolled as this member.

program_idstring required

Unique Voucherify ID of the loyalty program the member belongs to.

status'ACTIVE' | 'INACTIVE' | 'DELETED' required

Current member status. INACTIVE member can't earn points or redeem rewards.

metadataobject required

Free-form metadata attached to the member (empty object when none).

created_atstring date-time required

Timestamp when the member was created (ISO 8601).

updated_atstring date-time nullable required

Timestamp when the member was last updated (ISO 8601), or null if never updated.

object'member' required

Object type marker, always member.