> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voucherify.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Update program member
>
BETA endpoint
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](https://www.voucherify.io/contact-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](/api-reference/programs/activate-a-program-member) or [Deactivate a program member](/api-reference/programs/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.
## OpenAPI
````yaml /openapi/loyalties-v2.json put /v2/loyalties/programs/{programId}/members/{memberId}
openapi: 3.1.0
info:
title: Voucherify Loyalty v2 API
version: 2.0.0
description: >-
Complete OpenAPI specification for the Voucherify Loyalty v2 API.
All endpoints require the LOYALTY_V2 feature flag.
Combined from per-domain specs: programs.yaml, members.yaml,
program-operations.yaml, card-definitions.yaml, earning-rules.yaml,
tier-structures.yaml, benefits.yaml, rewards.yaml, examine.yaml
servers:
- url: '{protocol}://{host}'
variables:
protocol:
default: https
enum:
- https
- http
host:
default: api.voucherify.io
security:
- bearerAuth: []
X-App-Id: []
X-App-Token: []
tags:
- name: Programs
description: >-
Loyalty program CRUD, lifecycle management, program-scoped resource
assignments (card definitions, earning rules, rewards, tier structures),
member management (create, list, get, update, activate, deactivate,
delete), card operations (points adjustment, pending points, expiring
points, transactions), reward purchases, and activity history.
- name: Card Definitions
description: >-
CRUD operations, lifecycle management, and activity history for card
definitions. Card definitions describe the configuration for loyalty
cards, including code generation, points expiration, earning/spending
limits, pending points, refunds, and balance settings.
- name: Earning Rules
description: >-
Manage earning rules that define how customers earn points or receive
incentives based on triggers (events, segments, custom events). Includes
CRUD, lifecycle, and activity history.
- name: Tier Structures
description: >-
CRUD operations, lifecycle management, and activity history for tier
structures. Includes nested tier definitions (create, list, update,
delete) within tier structures. Tier structures define the tiering model
for loyalty programs — how members qualify for and move between tiers.
- name: Benefits
description: >-
Manage benefit definitions (fixed points, proportional points, material,
digital). Includes CRUD, lifecycle transitions, and activity history.
- name: Rewards
description: >-
CRUD, lifecycle operations, and activity history for reward definitions.
Rewards can be material (product/SKU) or digital (discount coupons, gift
vouchers).
- name: Examine
description: >-
Evaluation endpoints that estimate earning opportunities and reward
availability for a customer across their loyalty program memberships,
without side effects.
paths:
/v2/loyalties/programs/{programId}/members/{memberId}:
put:
tags:
- Programs
summary: Update program member
description: >-
BETA endpoint
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](https://www.voucherify.io/contact-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](/api-reference/programs/activate-a-program-member) or
[Deactivate a program
member](/api-reference/programs/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.
operationId: updateProgramMember
parameters:
- name: programId
in: path
required: true
description: Loyalty program ID (format `lprg_[a-f0-9]+`).
schema:
type: string
pattern: ^lprg_[a-f0-9]+$
- name: memberId
in: path
required: true
description: Program member ID (format `lmbr_[a-f0-9]+`).
schema:
type: string
pattern: ^lmbr_[a-f0-9]+$
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/MemberUpdateRequest'
responses:
'200':
description: The updated member (without cards).
content:
application/json:
schema:
$ref: '#/components/schemas/Member'
examples:
Updated member metadata:
value:
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
'400':
description: Validation error - request body failed validation.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Resource not found.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
Member not found:
value:
code: 404
key: not_found
message: Resource not found
details: Cannot find member with id lmbr_128f92dbc8c4ba5dc
request_id: v-12cf8bce66569748e7
resource_id: lmbr_128f92dbc8c4ba5dc
resource_type: member
Program not found:
value:
code: 404
key: not_found
message: Resource not found
details: Cannot find program with id lprg_12858429f4c4bf7b2
request_id: v-12cf8b960f5adeeb76
resource_id: lprg_12858429f4c4bf7b2
resource_type: program
'500':
description: Internal server error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
components:
schemas:
MemberUpdateRequest:
type: object
description: >-
Request body for updating a program member. Only metadata is updatable.
No additional properties are allowed.
properties:
metadata:
description: >-
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.
oneOf:
- type: object
- type: 'null'
required:
- metadata
additionalProperties: false
Member:
type: object
description: A loyalty program member.
properties:
id:
type: string
pattern: ^lmbr_[a-f0-9]+$
description: Unique member ID assigned by Voucherify.
customer_id:
type: string
pattern: ^cust_[a-zA-Z0-9]+
description: Unique Voucherify ID of the customer enrolled as this member.
program_id:
type: string
pattern: ^lprg_[a-f0-9]+$
description: Unique Voucherify ID of the loyalty program the member belongs to.
status:
type: string
enum:
- ACTIVE
- INACTIVE
- DELETED
description: >-
Current member status. `INACTIVE` member can't earn points or redeem
rewards.
metadata:
type: object
description: Free-form metadata attached to the member (empty object when none).
created_at:
type: string
format: date-time
description: Timestamp when the member was created (ISO 8601).
updated_at:
type:
- string
- 'null'
format: date-time
description: >-
Timestamp when the member was last updated (ISO 8601), or null if
never updated.
object:
type: string
const: member
description: Object type marker, always `member`.
required:
- id
- customer_id
- program_id
- status
- metadata
- created_at
- updated_at
- object
ErrorResponse:
type: object
description: Standard error response returned by all Loyalty v2 endpoints.
properties:
code:
type: integer
description: HTTP status code of the error.
key:
type: string
description: Machine-readable error key.
message:
type: string
description: Human-readable error message.
details:
type: string
description: Additional details about the error.
request_id:
type: string
description: Identifier of the request that produced the error.
resource_id:
type: string
description: Identifier of the resource that produced the error.
resource_type:
type: string
description: Type of the resource that produced the error.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
X-App-Id:
type: apiKey
name: X-App-Id
in: header
X-App-Token:
type: apiKey
name: X-App-Token
in: header
````