webhooks
Create Subscription
Create a new webhook subscription.
Supports both Microsoft Outlook (via Graph API) and Google Gmail
(via Pub/Sub watch). The provider field in the request body
determines which path is taken.
- Verifies the user has an active integration for the provider.
- Obtains a fresh access token via the stored refresh token.
- Registers the push subscription with the provider.
- Persists a
WebhookSubscriptionrow in the database.
POST
Create Subscription
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Response
Successful Response
Response after creating a subscription.
Create Subscription