> ## Documentation Index
> Fetch the complete documentation index at: https://redo-44af351d-docs-v3-graphql-api-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# webhookEndpoints
> List webhook endpoints.
**Required scopes:**
[`webhooks_read`](/docs/api-reference/v3/reference/scopes#scope-webhooks_read)
## Arguments
Forward pagination cursor — returns items after it. Pass an `edges[].cursor` or
`pageInfo.endCursor` from a previous page.
Backward pagination cursor — returns items before it. Pass an `edges[].cursor`
or `pageInfo.startCursor` from a previous page.
Forward pagination: returns the first N items (max 100, default 25). Use with
`after`; mutually exclusive with `last`/`before`.
Backward pagination: returns the last N items (max 100, default 25). Use with
`before`; mutually exclusive with `first`/`after`.
WebhookEndpointSortKey}>
Which key to sort by (defaults to the first key, newest-first). Combine with
`reverse` to flip direction.
Reverses the sort direction selected by `orderBy` (or its default).
## Returns
WebhookEndpointConnection!} required>
A paginated list of WebhookEndpoint items.
[WebhookEndpointEdge!]!} required>
The list of edges (each a node plus its pagination `cursor`).
Opaque cursor for this item; pass to `after`/`before` to page from here.
WebhookEndpoint!} required>
The item at this edge.
ApiVersion!} required>
The API version this endpoint's deliveries are shaped by.
DateTime!} required>
When the record was created.
An optional merchant-supplied label for the endpoint.
DateTime}>
When the endpoint was disabled, or null if active.
Why the endpoint was disabled, or null if active.
The id of this webhook endpoint.
DateTime}>
When a pending (staged, not-yet-activated) secret was created, if any.
DateTime!} required>
When the current signing secret became active.
[WebhookTopic!]!} required>
Topics this endpoint is subscribed to.
DateTime!} required>
When the record was last updated.
The URL deliveries are POSTed to.
[WebhookEndpoint!]!} required>
The nodes in this page, without the edge/cursor wrapper — a convenience over `edges`.
ApiVersion!} required>
The API version this endpoint's deliveries are shaped by.
DateTime!} required>
When the record was created.
An optional merchant-supplied label for the endpoint.
DateTime}>
When the endpoint was disabled, or null if active.
Why the endpoint was disabled, or null if active.
The id of this webhook endpoint.
DateTime}>
When a pending (staged, not-yet-activated) secret was created, if any.
DateTime!} required>
When the current signing secret became active.
[WebhookTopic!]!} required>
Topics this endpoint is subscribed to.
DateTime!} required>
When the record was last updated.
The URL deliveries are POSTed to.
PageInfo!} required>
Pagination metadata for the current page.
Cursor of the last edge in this page; pass to `after` to page forward.
Whether more items exist after this page (drives forward pagination with `first`/`after`).
Whether more items exist before this page (drives backward pagination with `last`/`before`).
Cursor of the first edge in this page; pass to `before` to page backward.
## Example
```graphql theme={null}
query {
webhookEndpoints(
after: "..."
before: "..."
first: 10
last: 10
orderBy: CREATED_AT
reverse: true
) {
nodes {
apiVersion
createdAt
description
disabledAt
disabledReason
id
pendingSecretCreatedAt
secretSetAt
# ...
}
pageInfo {
hasNextPage
endCursor
}
}
}
```