---
title: "List webhook subscriptions"
method: GET
path: "/api/v1/webhooks"
tags: ["Webhooks"]
---

# List webhook subscriptions

`GET /api/v1/webhooks`

## Request

- Base URL: `https://mailinapp.com`
- URL: `https://mailinapp.com/api/v1/webhooks`
- Auth: HTTP bearer

Rate limit: 30 requests/minute per key. Secrets are never listed.

## Response `200`

The account's subscriptions

- object
  - `subscriptions` WebhookSubscription[], required
    - `id` string, required
    - `apiKeyId` string
    - `url` string, uri, required
    - `events` WebhookEventType[], required
    - `createdVia` 'dashboard' | 'api' | 'zapier' | 'n8n', required
    - `status` 'active' | 'disabled', required
    - `disabledReason` 'gone' | 'api-key-revoked'
    - `createdAt` integer, required
    - `lastDeliveryAt` integer
    - `lastFailureAt` integer
    - `lastError` string

## Other responses

- `401`: Missing or invalid API key
- `429`: Too many requests for this key

---

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