Skip to main content
POST
/
v2
/
loyalties
/
programs
/
{programId}
/
members
Create member
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>",
  "status": "ACTIVE",
  "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>"
    }
  ]
}

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.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

X-App-Id
string
header
required
X-App-Token
string
header
required

Path Parameters

programId
string
required

Unique program identifier

Body

application/json
customer_id
string
required

ID of an existing customer to enroll as a member

Pattern: ^cust_[A-Za-z0-9]+$
status
enum<string> | null
default:ACTIVE

Initial member status (defaults to ACTIVE)

Available options:
ACTIVE,
INACTIVE,
null
metadata
object

Custom key-value metadata

Response

Member created successfully

id
string

Unique member identifier

customer_id
string

Associated customer identifier

program_id
string

Program the member belongs to

status
enum<string>

Current member status

Available options:
ACTIVE,
INACTIVE,
DELETED
metadata
object

Custom key-value metadata

created_at
string<date-time>

ISO 8601 creation timestamp

updated_at
string<date-time> | null

ISO 8601 last update timestamp

object
string
Allowed value: "member"
cards
object[] | null

Cards assigned to this member

Last modified on May 11, 2026