---
title: "Handle Gmail Webhook"
method: POST
path: "/email/webhooks/gmail/"
tags: ["email"]
---

# Handle Gmail Webhook

`POST /email/webhooks/gmail/`

## Request

- Base URL: `https://stardrift.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://stardrift.ai/email/webhooks/gmail/`
- Auth: none declared

Handle Gmail push notification from Google Pub/Sub.

Decodes the Pub/Sub message, looks up the GmailConnection by email,
and enqueues an incremental sync task for each matching connection.

## Response `204`

Successful Response

---

[API](https://skmtc.dev/stardrift/apis/stardrift-api.md) - [All operations](https://skmtc.dev/stardrift/apis/stardrift-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stardrift/apis/stardrift-api/revisions/be9ed1e6c38a?raw)