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

# Zapier

> Connect Onset to thousands of apps and automate your release workflow.

> [!NOTE]
>
> The Onset Zapier app is in beta. Zapier hasn't listed it publicly yet, so you
> need the invite link below to add it to your account.

Zapier connects Onset to thousands of other tools without writing code. Announce
releases where your team already works, log them in a spreadsheet, or add
subscribers from the forms and CRMs you already use.

## How to enable

**1. Create an API key**

Go to **Settings → Developers → API Keys** in your workspace and create a
key. Copy it — you'll only see it once.

**2. Open the Onset Zapier app**

Go to **Settings → Integrations** and click **Connect** on **Zapier**. That
opens the [invite link](https://zapier.com/developer/public-invite/149791/7913ed05f71e7fa3e651a251c8749968/)
that adds Onset to your Zapier account.

**3. Sign in to Onset**

When Zapier asks you to connect an Onset account, paste your API key. Zapier
validates it against your workspace right away.

## Triggers

Triggers start a Zap when something happens in Onset. They run on
[webhooks](https://onset.io/docs/developers/webhooks.md), so they fire within seconds instead of waiting
for a polling interval.

| Trigger | Fires when |
| - | - |
| New Release Note | A release is created in your workspace (`release.created`) |
| New Subscriber | Someone subscribes to your updates (`subscriber.created`) |

> [!NOTE]
>
> **New Release Note** fires on creation, not publication. A draft you're still
> writing will start the Zap, so add a filter step if you only want to act on
> releases that have gone live.

## Actions

Actions let another app write into Onset.

| Action | What it does |
| - | - |
| Create Release Note | Creates a release as a draft in your workspace |
| Update Release Note | Edits an existing release — title, body, or changes |
| Publish Release Note | Publishes a draft, immediately or at a scheduled date |
| Create Subscriber | Adds a subscriber, optionally to a specific list |

> [!WARNING]
>
> **Publish Release Note** doesn't send subscriber emails or Slack and Discord
> announcements — the same limitation applies to
> [publishing over the API](https://onset.io/docs/developers/api-reference/introduction.md). Publish from
> the dashboard when you want to pick notification channels. See
> [Publishing](https://onset.io/docs/guides/releases/publishing.md).

## Example Zaps

* **New Release Note → Slack/Teams/Discord.** Post an internal heads-up when a
  release is drafted, so the team can review before it ships.
* **New Release Note → Google Sheets.** Keep a running log of every release for
  reporting.
* **Typeform/HubSpot → Create Subscriber.** Add people to your changelog
  audience from wherever they sign up.
* **Jira/GitHub → Create Release Note.** Draft a release automatically when a
  version is cut, then edit and publish it in Onset.
* **Scheduled by Zapier → Publish Release Note.** Ship a prepared draft at a
  fixed time without anyone opening the dashboard.

## Working with your API key

The key you paste into Zapier has the same privileges as any other Onset API
key. Create a dedicated key for Zapier rather than reusing one, so you can
revoke it from **Settings → Developers → API Keys** without breaking your other
integrations.

If you'd rather build against Onset directly, the same data is available through
the [API](https://onset.io/docs/developers/api-reference/introduction.md) and
[webhooks](https://onset.io/docs/developers/webhooks.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.