---
title: "Read an account's webhook subscription"
method: GET
path: "/v1/accounts/{accountId}/webhook-subscription"
tags: ["Connect"]
---

# Read an account's webhook subscription

`GET /v1/accounts/{accountId}/webhook-subscription`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/accounts/{accountId}/webhook-subscription`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/zernio/apis/zernio-api/docs/v1/accounts/:accountId/webhook-subscription/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the webhook fields Zernio's app is subscribed to on the connected Page, read live from Meta.
Use it to confirm `leadgen` is present: a Page missing it keeps delivering every other event while
lead ads stop arriving, with nothing to indicate it.

For an Instagram account connected through Instagram Login it returns the subscription record
(`subscriptionId`) and the webhook fields Meta did not subscribe (`missingFields`). An Instagram account
connected through Facebook Login returns 409: its webhooks ride the Facebook Page subscription.

## Path parameters

- `accountId` string, required

## Response `200`

The Page's current subscription

- object
  - `pageId` string
  - `appSubscribed` boolean: False when the Page carries no subscription for our app at all.
  - `leadgen` boolean: Whether lead ads submitted on this Page reach Zernio in real time.
  - `subscribedFields` string[]
  - `warning` string, nullable: Present only when leadgen is missing.
  - `instagramUserId` string: Instagram accounts only.
  - `subscriptionId` string, nullable: Instagram accounts only. Id of the subscription record on Meta; null when there is none.
  - `missingFields` string[]: Instagram accounts only. Webhook fields Zernio expects that Meta did not subscribe.

## Other responses

- `400`: Invalid request
- `404`: Resource not found
- `409`: The Facebook connection has no selected Page, or the Instagram account connected through Facebook Login, is disconnected, or has no access token

## Changes

- **2026-11-10** `d568bb00ed73`: 5 info
  - added the optional property `docsUrl` to the response with the `400` status
  - added the optional property `provider` to the response with the `400` status
  - added the optional property `providerError` to the response with the `400` status
  - added the optional property `requestId` to the response with the `400` status
  - …1 more
- **2026-11-09** `6923506bffaa`: 3 info
  - added the optional property `instagramUserId` to the response with the `200` status
  - added the optional property `missingFields` to the response with the `200` status
  - added the optional property `subscriptionId` to the response with the `200` status
- **2026-10-06** `f8c8f34fb41a`: 1 warning
  - added the new `account` enum value to the `details/budgetScope` response property for the response status `400`
- **2026-10-02** `d556591af3f6`: 1 info
  - added the optional property `docUrl` to the response with the `400` status
- **2026-09-30** `16a7b9d5373e`: 1 info
  - removed the `platform` enum value from the `details/budgetScope` response property for the response status `400`

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/accounts/:accountId/webhook-subscription/get.md)

---

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