> ## Documentation Index
> Fetch the complete documentation index at: https://zju-a00451d9-feat-personal-agent-team.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# webhooks

# `velaclaw webhooks`

Webhook helpers and integrations (Gmail Pub/Sub, webhook helpers).

Related:

* Webhooks: [Webhooks](/automation/cron-jobs#webhooks)
* Gmail Pub/Sub: [Gmail Pub/Sub](/automation/cron-jobs#gmail-pubsub-integration)

## Gmail

```bash theme={null}
velaclaw webhooks gmail setup --account you@example.com
velaclaw webhooks gmail run
```

### `webhooks gmail setup`

Configure Gmail watch, Pub/Sub, and Velaclaw webhook delivery.

Required:

* `--account <email>`

Options:

* `--project <id>`
* `--topic <name>`
* `--subscription <name>`
* `--label <label>`
* `--hook-url <url>`
* `--hook-token <token>`
* `--push-token <token>`
* `--bind <host>`
* `--port <port>`
* `--path <path>`
* `--include-body`
* `--max-bytes <n>`
* `--renew-minutes <n>`
* `--tailscale <funnel|serve|off>`
* `--tailscale-path <path>`
* `--tailscale-target <target>`
* `--push-endpoint <url>`
* `--json`

Examples:

```bash theme={null}
velaclaw webhooks gmail setup --account you@example.com
velaclaw webhooks gmail setup --account you@example.com --project my-gcp-project --json
velaclaw webhooks gmail setup --account you@example.com --hook-url https://gateway.example.com/hooks/gmail
```

### `webhooks gmail run`

Run `gog watch serve` plus the watch auto-renew loop.

Options:

* `--account <email>`
* `--topic <topic>`
* `--subscription <name>`
* `--label <label>`
* `--hook-url <url>`
* `--hook-token <token>`
* `--push-token <token>`
* `--bind <host>`
* `--port <port>`
* `--path <path>`
* `--include-body`
* `--max-bytes <n>`
* `--renew-minutes <n>`
* `--tailscale <funnel|serve|off>`
* `--tailscale-path <path>`
* `--tailscale-target <target>`

Example:

```bash theme={null}
velaclaw webhooks gmail run --account you@example.com
```

See [Gmail Pub/Sub documentation](/automation/cron-jobs#gmail-pubsub-integration) for the end-to-end setup flow and operational details.