
Connect
1
Open the OneSignal integration in Brew
In Brew, go to Integrations and click the OneSignal card.
2
Go to Keys & IDs in OneSignal
In OneSignal, go to your app’s dashboard, click Settings, then Keys & IDs.
3
Copy your App ID
Copy the App ID. Go back to Brew and paste it into the App ID field.
4
Copy or create your API key
If you don’t have an App API Key yet, click Add Key and enter a name such as “Brew”. Leave the IP allowlist empty, then click Create and copy the key. Use an App API Key, not an Organization API key.
5
Paste the API key in Brew
Go back to Brew, paste the API key into the second field, and click Connect.
Export a Template
Once connected, you can export any email to OneSignal:- Open an email you’ve created in Brew
- Click Send
- Choose to export the template to OneSignal
- Give it a name, check the subject line, and click Export
Where It Lands
The template appears in OneSignal under Messages → Templates within your OneSignal app, ready to use in your campaigns. To view it, open Options on the template and click Edit.Editing and Re-exporting
Templates are editable only as HTML, not in a drag-and-drop block editor. Make design changes in Brew and re-export. To send a test email, scroll down to the 2. Message section within the Edit view and click Test & preview.Merge Tags and Unsubscribe Link
OneSignal reads the recipient’s address from the subscription and every other field from user tags:
A bare field such as
firstName reads the user tag of the same name, so match its spelling exactly. Trigger fields such as {{ trigger.orderId }} stay as written. Data you send with the API request lives under message.custom_data, as in {{ message.custom_data.orderId }}.
The unsubscribe link becomes [unsubscribe_url]. Test sends show a working link only from a verified sending domain.
OneSignal reference: properties and tags, Liquid and API custom data.
From an Agent or Code
Connect OneSignal in the app first. Then, with Brew connected to your AI assistant over MCP, ask in plain English:“Export my welcome email to OneSignal as a template.”From code, send with . Export is free. Pass
dryRun: true to check the design and the connection without creating a template. A dry run doesn’t test whether OneSignal accepts the template: only a real export does.
The template takes the email’s title unless you pass templateName (up to 100 characters), and the response returns its templateId. If an export fails, the error says why:
INTEGRATION_NOT_CONNECTED: OneSignal isn’t connected to this brand. Connect it on the Integrations page.EXPORT_UNSUPPORTED: OneSignal rejected a field value it doesn’t support. Change the value and export again.EXPORT_PROVIDER_ERROR: OneSignal refused or failed the export. Check the connection and retry.
Requirements
- A OneSignal account with an app created
- Your App ID (found under Settings → Keys & IDs)
- An App API Key
Need Help?
Our team is ready to support you at every step of your journey with Brew. Choose the option that works best for you:- Self-Service Tools
- Talk to Our Team
Search Documentation
Type in the “Ask any question” search bar at the top left to instantly find relevant documentation pages.
Ask ChatGPT or Claude
Click here to open the Copy page menu at the top of this page, then send the page to ChatGPT, Claude, or your editor.