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

# Configure Notifications and Alerts for Your Workspace

> Set up email, in-app, and Slack notifications in Google to stay informed about project updates, mentions, API errors, and team activity.

Staying on top of activity in your Google workspace is effortless when notifications are configured to match how you and your team actually work. Whether you prefer real-time alerts in Slack, a daily email digest, or a quick glance at the in-app notification bell, Google gives you the flexibility to tailor every alert type to your personal workflow — and to silence the noise for projects that do not need your attention right now.

## Notification Types

Google can notify you about the following categories of events. You can toggle each type on or off individually across email, in-app, and Slack channels.

* **Mentions** — someone @mentions you in a comment, record, or project description
* **Project Updates** — a project you follow is renamed, archived, or has its settings changed
* **Record Changes** — a record you own or are subscribed to is created, updated, or deleted
* **API Errors** — one of your API keys encounters a sustained error rate above a configurable threshold
* **Billing Alerts** — upcoming renewal reminders, failed payment attempts, and plan limit warnings
* **Security Events** — new device logins, 2FA changes, IP allowlist violations, and API key rotations

## In-App Notifications

The notification bell (🔔) in the top-right corner of every page is your real-time hub for workspace activity. A red badge shows the count of unread notifications.

* **View notifications** — click the bell to open the notification panel. Each entry shows the event type, a short description, and a timestamp. Click any notification to navigate directly to the relevant resource.
* **Mark as read** — hover over a notification and click the checkmark, or click **Mark all as read** at the top of the panel to clear all unread indicators at once.
* **Filter by type** — use the **Filter** dropdown inside the notification panel to show only specific event categories, such as Mentions or API Errors.
* **Notification history** — the panel retains the last 500 notifications. For a complete history, navigate to **Settings → Notifications → Activity Log**.

## Email Notifications

You have full control over which events trigger an email and how frequently those emails are batched.

<Steps>
  <Step title="Open Notification Settings">
    Click your **avatar** in the top-right corner and go to **Settings → Notifications → Email**.
  </Step>

  <Step title="Toggle Events On or Off">
    You will see a list of all notification types. Use the toggle next to each event to enable or disable email delivery for that event. Changes are saved automatically.
  </Step>

  <Step title="Set Digest Frequency">
    For each enabled event type, choose a delivery frequency from the dropdown:

    * **Immediate** — sends an email as soon as the event occurs
    * **Daily Digest** — bundles all events of that type into a single email sent each morning at 8 AM in your workspace timezone
    * **Weekly Digest** — sends a summary email every Monday morning
  </Step>

  <Step title="Verify Your Email Address">
    Ensure the email address on your account is correct by checking **Settings → Profile**. All notification emails are sent to your primary account email.
  </Step>
</Steps>

<Note>
  Every notification email includes an **Unsubscribe** link at the bottom that immediately disables that specific notification type for your account. You can re-enable it at any time by returning to **Settings → Notifications → Email**.
</Note>

## Slack Notifications

Connect your Google workspace to Slack and route specific event types to dedicated channels so your team never misses a critical update.

<Steps>
  <Step title="Connect Your Slack Workspace">
    Navigate to **Settings → Integrations → Slack** and click **Connect to Slack**. You will be redirected to Slack's OAuth authorization page. Approve the permissions to allow Google to post messages on your behalf.
  </Step>

  <Step title="Select Default Channel">
    After connecting, choose a **Default Channel** where Google will send notifications that do not have a more specific channel mapping.
  </Step>

  <Step title="Map Event Types to Channels">
    In the **Channel Mapping** table, assign each event type (Mentions, API Errors, Billing Alerts, etc.) to the Slack channel that should receive it. For example, you might send API Errors to `#engineering-alerts` and Billing Alerts to `#finance`.
  </Step>

  <Step title="Test the Connection">
    Click **Send Test Message** to verify that Google can post to your selected channels. If the test message does not arrive, check that the Google bot has been invited to private channels with `/invite @google`.
  </Step>

  <Step title="Enable Notifications">
    Toggle **Slack Notifications** to **On** and click **Save**. Google will begin sending messages immediately.
  </Step>
</Steps>

<Tip>
  Create a dedicated `#google-alerts` channel in Slack and route all notification types there initially. Once you understand which events are most actionable for which teams, you can refine the channel mapping over time.
</Tip>

## Webhook Notifications

For custom or programmatic notification workflows — such as routing alerts to PagerDuty, a custom dashboard, or your own backend service — Google supports outbound webhooks. When an event occurs, Google sends an HTTP POST request with a JSON payload to your specified endpoint.

To set up webhook notifications, see the [Webhooks documentation](/api/webhooks). That page covers endpoint registration, payload schemas, signature verification, and retry behavior.

## Notification Preferences per Project

If a particular project is generating too much noise, you can mute notifications for it without affecting your settings for other projects.

1. Open the project you want to mute.
2. Click the **more options** (⋯) menu near the project title.
3. Select **Notification Preferences**.
4. Toggle **Mute this project** to **On**.

While a project is muted, you will not receive any in-app, email, or Slack notifications for activity within that project. You can unmute it at any time by returning to the same menu and toggling it back off. Muting is personal — it only affects your own notifications and does not change settings for other team members.