Skip to main content
POST
/
v2
/
loyalties
/
programs
/
{programId}
/
members
/
batch
Error
A valid request URL is required to generate request examples
{
  "async_action_id": "<string>"
}
{
"code": 123,
"key": "<string>",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}
{
"code": 123,
"key": "<string>",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}
{
"code": 123,
"key": "<string>",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}
{
"code": 123,
"key": "<string>",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}
{
"code": 123,
"key": "<string>",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}

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

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

Pattern: ^lprg_[a-f0-9]+$

Body

application/json
customer_id
string
required

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

Pattern: ^cust_[a-zA-Z0-9]+
status
enum<string> | null
default:ACTIVE

Initial member status. Defaults to ACTIVE when omitted.

Available options:
ACTIVE,
INACTIVE
metadata
object | null

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

Response

Batch creation has been scheduled.

Result of scheduling the members batch creation.

async_action_id
string
required

ID of the scheduled async action processing the batch.

Pattern: ^aa_[a-f0-9]+$
Last modified on July 10, 2026