Bloomreach activities
Use Bloomreach scenarios to create, update, and notify Apple Wallet and Google Wallet passes managed in The Wallet Crew.
Bloomreach activities are scenario steps that call The Wallet Crew APIs. They turn a CRM decision (who/when/what) into a wallet action (create, update, notify).
Activity catalog
These activities are typically created in Bloomreach as Webhook preset integrations. Each activity calls one The Wallet Crew endpoint.
HTTP authentication setup is covered in Setup. Each activity below gives its install payload, written in the Bloomreach WebHook preset parameter syntax. Install only the activities you need: it keeps scenario building simple and reduces configuration drift. One Bloomreach integration is typically created per activity.
The endpoint URLs below use <host> (see Environments and URLs) and <<tenantId>>: replace <<tenantId>> with the tenant identifier. API details: API reference.
Activity icons are available as a file:
Notify

Notify sends a wallet message to a pass. On Apple Wallet, the message is delivered as a lock‑screen notification. On Google Wallet, the message appears on the pass.
Apply benefit

Apply benefit attaches a benefit to a pass. That benefit can be a coupon, an access right, or a perk.
Benefits are first-class objects in The Wallet Crew. They can be displayed on the pass and tracked over time.
Apply benefit fits benefits with a lifecycle (availability, expiry, redemption). For the full concept, see Benefit templates.
Update pass

Update pass refreshes a pass so it reflects the latest data. This is the primary activity used to keep the pass accurate.
Typical updates include points, tier, balance, expiry, seat, venue, and instructions.
Add benefit movement (advanced, on request)
This activity updates a counter on an existing benefit. This is mainly used for punch cards, “progress to reward”, or multi-entry packs.
The activity calls POST https://<host>/api/<<tenantId>>/passes/benefits/<benefitId>/movements. The body carries oldValue (the balance as last read; the movement is refused with 409 if the balance changed since), value (a signed whole number: positive credits, negative redeems) and optional remarks. The benefitId is returned by Apply benefit. The Bloomreach install payload is provided on request.
Create pass (advanced, on request)
Create pass generates a new pass and returns its identifier. This is useful when Bloomreach is the orchestration layer and a pass does not exist yet.
The activity calls POST https://<host>/api/<<tenantId>>/passes?passType=<pass template> with the pass identifiers and additionalData in the body. The Bloomreach install payload is provided on request.
FAQ
Last updated

