69be73b5cff0

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

Batch create program members

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

The program must exist (otherwise, it returns a 404 error) and be in ACTIVE status (otherwise, it returns a 423 error). Supported member fields are validated during background processing using the same domain validation rules as single member creation. Entries that fail validation (missing/invalid customer_id, unknown customer, invalid status, duplicate customer_id within the same batch, member already exists) are reported per-entry individually in the report linked from the async action result. The failed entries do not fail the whole batch (conflicting members are skipped).

Returns 202 status with the identifier of the scheduled async action. Use the GET Async Action endpoint to check the status of the batch creation. You can also check the processing status and the result in the Audit log – Background tasks in the Voucherify dashboard.

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

Path parameters

programIdstring required

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

Request body

status'ACTIVE' | 'INACTIVE' nullable

Initial member status. Defaults to ACTIVE when omitted or null.

metadataobject nullable

Free-form metadata attached to the member. Validated against the metadata schema defined for the vl_member related object (when one is configured). Defaults to an empty object.

Response

Batch creation has been scheduled.

async_action_idstring required

ID of the scheduled async action processing the batch.