> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brew.new/llms.txt
> Use this file to discover all available pages before exploring further.

# OneSignal

> Export email templates directly to OneSignal for campaigns and automations.

Connect your OneSignal account to export email templates created in Brew directly into OneSignal. No manual copy-pasting, just design in Brew and export to OneSignal in one click.

<Frame>
  <img src="https://mintcdn.com/brew-796f053a/PUK-uvvrJtpQ2VX2/images/integrations/OneSignal_OG.png?fit=max&auto=format&n=PUK-uvvrJtpQ2VX2&q=85&s=686df982314d3b2c7e56764f0530cbaf" alt="OneSignal Integration" className="w-full rounded-xl" width="1024" height="571" data-path="images/integrations/OneSignal_OG.png" />
</Frame>

## Setup

<Steps>
  <Step title="Open the OneSignal integration in Brew">
    In Brew, go to **Integrations** and click the **OneSignal** card.
  </Step>

  <Step title="Go to Keys & IDs in OneSignal">
    In OneSignal, go to your app's dashboard, click **Settings**, then **Keys & IDs**.
  </Step>

  <Step title="Copy your App ID">
    Copy the **App ID** shown at the top of the page. Go back to Brew and paste it into the App ID field.
  </Step>

  <Step title="Copy or create your API Key">
    Create an **App API Key** if you don't have one yet, then copy it.

    <Warning>
      OneSignal only shows the API key once when it's created. Save it in a secure location.
    </Warning>
  </Step>

  <Step title="Paste the API Key in Brew">
    Go back to Brew, paste the API key into the second field, and click **Connect**.
  </Step>
</Steps>

That's it. OneSignal is now connected to Brew.

## Exporting a Template

Once connected, you can export any email to OneSignal:

1. Open an email you've created in Brew
2. Click **Send**
3. Choose to **export the template to OneSignal**
4. Give it a name and click **Export**

The template appears in OneSignal under **Messages → Templates**, ready to use in your campaigns.

## What to Expect after Exporting

Exported templates are available under **Messages → Templates** within your OneSignal app. To view the template, click on it and select **Edit**. Templates are editable via HTML only and are not accessible through a drag-and-drop block editor. Any design changes should be made in Brew and re-exported.

To send a test email, scroll down to the **2. Message** section within the Edit view and click **Test & preview**.

## Requirements

* A OneSignal account with an app created
* Your App ID (found under Settings → Keys & IDs)
* An App API Key

<Snippet file="need-help.mdx" />