v18

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

Programs

Batch create program members

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

Schedules asynchronous batch creation of program members. The request body is a JSON array of member entries (maximum body size 10485760 bytes / 10 MB). The request is processed asynchronously in batches of 100 entries.

The program must exist (404) and be in ACTIVE status (423). Each entry is validated during background processing the same way as single member creation; entries that fail validation (missing/invalid customer_id, unknown customer, invalid status, member already exists) are reported per-entry in the async action result and do not fail the whole batch (conflicting members are skipped).

Returns 202 with the identifier of the scheduled async action.

post/v2/loyalties/programs/{programId}/members/batch

Path parameters

programIdstring required

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

Request body

customer_idstring required

ID of an existing customer to enroll as a member. Required per entry.

status'ACTIVE' | 'INACTIVE' nullable

Initial member status. Defaults to ACTIVE when omitted.

metadataobject nullable

Free-form metadata attached to the member. Defaults to an empty object.

Response

Batch creation has been scheduled.

async_action_idstring required

ID of the scheduled async action processing the batch.