Notifications

When certain events happen in Airplane, users may receive notifications. All notifications appear in the user's Inbox and may also be sent over email or Slack.

Default notifications

By default, you'll receive notifications for the following events:

Run and session failures. A run or session that you started or requested fails. This includes runs or sessions created by a schedule.
Run cancellations. Someone cancels a run that you started or requested. Additionally, you'll get notified if you or a group you're in was a reviewer of the request.
New runs and sessions. Someone approves one of your requests, or you were a reviewer (or in a group that was a reviewer) of a request that got approved.
New requests. Someone names you (or a group that you're in) as a reviewer of a request.
Rejected requests. Someone rejects your request.
Paused schedules. Someone (or the Airplane system) pauses a schedule that you created.
Deployment failures. A deployment that you kicked off failed. Additionally, the admin group will be notified if a git-based deployment fails.

Notifications are intelligent—they will not be sent if you are already aware of the event. For example, if a run fails while you are viewing the run, you will not receive a notification.

Customizing your notification preferences

You can customize your notification preferences to enable or disable email / Slack notifications. Turning off a notification will e.g. stop sending an email, but you'll still receive it in the in-app inbox.

Slack notifications require that a team admin set up the Slack integration first.

Notification subscriptions

In addition to receiving the default notifications, you can also subscribe to specific events on tasks, runbooks, and schedules. On the individual task, runbook or schedule page, click the notification bell in the header to manage subscriptions.

Here, you can change your subscription to the task, runbook, or schedule. By default, you will receive both emails and Slack notifications for any event that you are subscribed to. (You can change this setting in your notification preferences, under Subscriptions.)

Notifying Slack channels and email addresses

If you have admin permissions, you can subscribe other users, Slack channels, and email addresses to events associated with the task, runbook, or schedule.

When an email address is subscribed, someone with access to that email must confirm the subscription before any notifications are sent. Only active subscriptions are displayed in the notification subscriptions panel.

Team notification subscriptions

If you have admin permissions, you can also create team-wide subscriptions that notify a user, Slack channel, or email address when events occur on any task across your team.

To create a team subscription, go to the Team notifications page. Team subscriptions are overriden by notification subscriptions on individual tasks. For example, if you have a team subscription to notify a Slack channel when any task fails, but you also have an individual subscription on a task to notify a different Slack channel when that task fails, only the individual subscription will be used. You can also opt out of team notifications on a per-task basis.

Team notifications only support task run events.