circle-exclamation
This documentation is currently under development. Certain sections are not yet complete and will be added shortly.

Brevo

Send Apple Wallet and Google Wallet “Add to Wallet” links from Brevo by importing a `WALLET_LINK` contact attribute.

Brevo can be used to distribute Apple Wallet and Google Wallet passes by email. This setup enriches Brevo contacts with a secure Wallet link, then reuses it in Brevo templates.

chevron-rightReal-world exampleshashtag
  • A retail brand sends a loyalty “Add to Wallet” link after newsletter signup.

  • A gift card program sends a “Save your gift card” link after purchase.

  • A membership program sends a renewal email that includes the updated pass link.

Prerequisites

Brevo contacts must be exportable and importable. Brevo attributes must also be manageable.

The Wallet Crew must be configured to generate an authToken per email. This token is used to build a secure “Add to Wallet” URL.

If passes are normally generated from a CRM connector (Cegid, Openbravo, etc.), emails imported from Brevo must exist in that system. If that is not the case, use Via Email to generate and send secure “Add to Wallet” links.

Brevo contact update rules and CSV import constraints are documented by Brevo: https://help.brevo.com/hc/en-us/articles/10227982847762-Update-the-information-of-your-contacts

circle-exclamation
circle-info

Needs confirmation: the base “pass landing page” URL can vary by environment and project setup. The correct base URL should be taken from The Wallet Crew project configuration.

Setup

1

1) Export contacts from Brevo

Export a CSV from the Brevo contact list with the email field.

Open: https://app.brevo.com/contact/list

In the Brevo UI, select Contacts → More actions → Export.

Brevo contact list export menu: Contacts → More actions → Export
Start a contact export from the Brevo contact list.

Use the following options:

  • Attributes to export: EMAIL

  • CSV field separator: , (comma)

Brevo export contacts options showing EMAIL attribute and comma separator
Export only what is needed. Keep the file minimal.

The file becomes available in the Brevo notification center.

2

Create a text attribute to store the Wallet link per contact.

In Brevo, go to the attributes screen and select Add a new attribute.

Brevo attributes screen with the 'add a new attribute' action
Create a new custom attribute for Wallet links.

Create the attribute with:

  • Attribute Name: WALLET_LINK

  • Attribute Type: Text

Brevo new attribute form filled with WALLET_LINK and type Text
`WALLET_LINK` stores the per-contact “Add to Wallet” URL.
3

3) Generate authToken values in The Wallet Crew

In The Wallet Crew admin console, open Token Generator. Generate an authToken based on email.

The Wallet Crew Token Generator with a list of emails pasted for token generation
Generate one token per email.

This step typically outputs a list of {EMAIL, authToken} values. Store them in a working sheet for the next step.

4

For each contact, concatenate:

  • the project “pass landing page” base URL

  • the query parameter neo.authToken

Example output:

  • https://<host>/<tenant>/pass?neo.authToken=<authToken>

In Excel or Google Sheets, a typical formula looks like:

  • =BASE_URL & "?neo.authToken=" & AUTH_TOKEN_CELL

The resulting CSV should contain at least:

  • EMAIL

  • WALLET_LINK

5

Import the updated CSV so Brevo writes WALLET_LINK on each contact.

Brevo import contacts entry point screen
Start a contact import to update attributes.

Upload the CSV file:

Brevo import flow step to upload a CSV file
Select the enriched file that contains `WALLET_LINK`.

Map fields and confirm the import:

Brevo import field mapping screen for WALLET_LINK
Map `WALLET_LINK` to the custom attribute.

Once completed, validate the import report:

Brevo import completed confirmation
Brevo confirms the import job status.
Brevo import report screen showing the summary and potential errors
Use the report to catch missing emails or rejected rows.
6

6) Add an “Add to Wallet” button in the Brevo email template

Add a link or button in the email template that points to the WALLET_LINK attribute.

Brevo email template editor where a button link uses the WALLET_LINK attribute
Use the contact attribute as the button URL.

Add a display condition so the block only shows when WALLET_LINK is present.

Brevo email template conditional display settings using WALLET_LINK availability
Hide the Wallet block when the contact has no Wallet link.

FAQ

chevron-rightWhat happens if a contact email does not exist in the connected CRM?hashtag

The Wallet Crew may be unable to resolve an existing customer record for pass creation or updates. In that case, prefer Via Email, which distributes project-generated secure links through The Wallet Crew email flow.

chevron-rightShould `authToken` be stored long-term in Brevo?hashtag

This depends on the security policy and token lifetime defined for the project. If tokens expire or must be rotated, regenerate and re-import WALLET_LINK values before each campaign.

Last updated