Create Wallet Messaging Batch [BETA]
Create a new wallet messaging batch using segments, recipients, or a CSV file (via multipart/form-data).
For more details, see the Wallet Messaging documentation.
curl --request POST \
--url https://api.passentry.com/api/v1/entities/{id}/messaging/wallet \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"batch": {
"message": "Hello, World!",
"segments": [
{
"groupTag": "summerPromotion"
}
],
"scheduledAt": "2030-03-31T13:16:26Z"
}
}'{
"data": {
"id": "d29455c9-afe4-4c73-b946-a5ea0b1667f7",
"type": "walletMessaging",
"attributes": {
"name": "Summer Promotion 01/06/2025",
"status": "validating",
"tag": null,
"content": "Hello, World!",
"scheduledAt": "2030-03-31T13:16:26Z"
}
},
"links": {
"self": "https://api.passentry.com/api/v1/batches/d29455c9-afe4-4c73-b946-a5ea0b1667f7"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Entity ID
Body
Message to be sent. Include %{variable} for dynamic content.
"Hey %{memberName}, thank you for your purchase!"
ISO8601 timestamp of when the batch is scheduled to be sent
Response
UUID of the batch
Type of batch
walletMessaging Friendly name of the batch, used for display purposes
"PassEntry Supermarket Summer Promotion"
Status of the batch
validating, scheduled, failed, sending, successful, completedWithErrors, cancelled Tag of the batch, used for grouping and filtering purposes
"summerPromotion"
Message content
"Welcome to PassEntry Supermarket! We're excited to have you as a member. Get 10% off your first purchase by showing your pass at the till!"
Total number of recipients in the batch
12000
ISO8601 timestamp of when the batch was completed
"2021-01-01T00:00:00Z"
ISO8601 timestamp of when the batch is scheduled to be sent
"2022-01-01T00:00:00Z"
If present, batch failed validation, or had some errors during delivery. URL to a CSV file containing errors and error details of the batch
"https://example.com/errors.csv"
If present, batch was completed. URL to a CSV file containing message delivery details for each recipient.
"https://example.com/delivery.csv"
Was this page helpful?
curl --request POST \
--url https://api.passentry.com/api/v1/entities/{id}/messaging/wallet \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"batch": {
"message": "Hello, World!",
"segments": [
{
"groupTag": "summerPromotion"
}
],
"scheduledAt": "2030-03-31T13:16:26Z"
}
}'{
"data": {
"id": "d29455c9-afe4-4c73-b946-a5ea0b1667f7",
"type": "walletMessaging",
"attributes": {
"name": "Summer Promotion 01/06/2025",
"status": "validating",
"tag": null,
"content": "Hello, World!",
"scheduledAt": "2030-03-31T13:16:26Z"
}
},
"links": {
"self": "https://api.passentry.com/api/v1/batches/d29455c9-afe4-4c73-b946-a5ea0b1667f7"
}
}