curl --request POST \
--url https://api.voucherify.io/v2/loyalties/programs/{programId}/members \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-App-Id: <api-key>' \
--header 'X-App-Token: <api-key>' \
--data '
{
"customer_id": "<string>",
"status": "ACTIVE",
"metadata": {}
}
'{
"id": "<string>",
"customer_id": "<string>",
"program_id": "<string>",
"metadata": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"object": "<string>",
"cards": [
{
"member_role": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"card": {
"id": "<string>",
"card_definition_id": "<string>",
"card_type": "<string>",
"code": "<string>",
"lifetime_bucket": {
"points": {
"total": 123,
"earned": 123,
"added": 123,
"subtracted": 123,
"expired": 123,
"spent": 123,
"refunded": 123,
"returned": 123,
"locked": 123,
"unlocked": 123
},
"pending_points": {
"total": 123,
"activated": 123,
"canceled": 123
}
},
"balance": {
"points": 123,
"pending_points": 123
},
"next_expiration": {
"points": 123,
"date": "2023-12-25"
},
"next_activation": {
"points": 123,
"type": "<string>",
"date": "2023-12-25",
"cancel_date": "2023-12-25"
},
"object": "<string>"
},
"object": "<string>"
}
]
}Create 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 or your Technical Account Manager.
Creates a new member in the specified program. The customer must exist and the program must be in ACTIVE status. Cards are automatically created for the member based on the program’s card definition assignments. Returns the member with their assigned cards.
Note: Card code generation is asynchronous. Cards will appear in the response, but the code field may be null immediately after creation. The code is generated asynchronously and becomes available shortly after.
curl --request POST \
--url https://api.voucherify.io/v2/loyalties/programs/{programId}/members \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-App-Id: <api-key>' \
--header 'X-App-Token: <api-key>' \
--data '
{
"customer_id": "<string>",
"status": "ACTIVE",
"metadata": {}
}
'{
"id": "<string>",
"customer_id": "<string>",
"program_id": "<string>",
"metadata": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"object": "<string>",
"cards": [
{
"member_role": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"card": {
"id": "<string>",
"card_definition_id": "<string>",
"card_type": "<string>",
"code": "<string>",
"lifetime_bucket": {
"points": {
"total": 123,
"earned": 123,
"added": 123,
"subtracted": 123,
"expired": 123,
"spent": 123,
"refunded": 123,
"returned": 123,
"locked": 123,
"unlocked": 123
},
"pending_points": {
"total": 123,
"activated": 123,
"canceled": 123
}
},
"balance": {
"points": 123,
"pending_points": 123
},
"next_expiration": {
"points": 123,
"date": "2023-12-25"
},
"next_activation": {
"points": 123,
"type": "<string>",
"date": "2023-12-25",
"cancel_date": "2023-12-25"
},
"object": "<string>"
},
"object": "<string>"
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Unique program identifier
Body
Response
Member created successfully
Unique member identifier
Associated customer identifier
Program the member belongs to
Current member status
ACTIVE, INACTIVE, DELETED Custom key-value metadata
ISO 8601 creation timestamp
ISO 8601 last update timestamp
"member"Cards assigned to this member
Show child attributes
Show child attributes
Was this page helpful?

