From 369bd76359b043272f7261fd13d34c8cbe26d5e7 Mon Sep 17 00:00:00 2001 From: AmandaYao00 Date: Tue, 7 Jul 2026 14:09:17 -0700 Subject: [PATCH] "update notification docs" --- src/notifications/notification-payloads.mdx | 4 ++-- src/notifications/overview.mdx | 7 ++++--- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/src/notifications/notification-payloads.mdx b/src/notifications/notification-payloads.mdx index 111359d6..898b7d70 100644 --- a/src/notifications/notification-payloads.mdx +++ b/src/notifications/notification-payloads.mdx @@ -413,8 +413,8 @@ Note: For partial failures, `success` is `false` with both `successfulRecordIds` - -`connection.created`, `connection.refreshed`, and `connection.deleted` share the same payload shape. `notificationType` reflects the specific event. + +`connection.created`, `connection.refreshed`, `connection.updated`, and `connection.deleted` share the same payload shape. `notificationType` reflects the specific event. **Webhook destination payload:** ```json diff --git a/src/notifications/overview.mdx b/src/notifications/overview.mdx index 2191171e..1323abcb 100644 --- a/src/notifications/overview.mdx +++ b/src/notifications/overview.mdx @@ -35,12 +35,13 @@ Ampersand supports the following notification event types: **Connection** - **`connection.created`**: Fires when a new OAuth connection is established with a SaaS provider -- **`connection.refreshed`**: Fires when a connection's OAuth access token is refreshed -- **`connection.deleted`**: Fires when a connection is deleted +- **`connection.refreshed`**: Fires when Ampersand automatically refreshes a connection's OAuth access token as it nears expiry, using the connection's refresh token. This happens with no user involvement and keeps the connection active +- **`connection.updated`**: Fires when an existing connection is updated, either when a user re-authenticates (for example, reconnecting to resolve an errored connection) or when the connection's credentials or metadata are changed via the update connection API +- **`connection.deleted`**: Fires when a connection is deleted, such as through the dashboard or the delete connection API - **`connection.error`**: Fires when there's an error with an OAuth connection, such as authentication failures or token refresh issues **Destination** -- **`destination.webhook.disabled`**: Fires when a webhook destination endpoint is disabled +- **`destination.webhook.disabled`**: Fires when a webhook destination endpoint is disabled. This can happen automatically after repeated failed delivery attempts. ## Setting up notifications