> ## 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.

# webhookEndpoint

> Fetch a single webhook endpoint by its id.

**Required scopes:**
[`webhooks_read`](/docs/api-reference/v3/reference/scopes#scope-webhooks_read)

## Arguments

<ResponseField name="id" type="ID!" required>
  The id of the webhook endpoint to fetch.
</ResponseField>

## Returns

<ResponseField name="webhookEndpoint" type={<a href="/docs/api-reference/v3/reference/webhooks/webhook-endpoint">WebhookEndpoint</a>}>
  A destination the merchant has registered to receive webhook deliveries.
  `disabledAt` is null while active.

  <Expandable title="fields" lazyRender>
    <ResponseField name="apiVersion" type={<a href="/docs/api-reference/v3/reference/webhooks/api-version">ApiVersion!</a>} required>
      The API version this endpoint's deliveries are shaped by.
    </ResponseField>

    <ResponseField name="createdAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime!</a>} required>
      When the record was created.
    </ResponseField>

    <ResponseField name="description" type="String">
      An optional merchant-supplied label for the endpoint.
    </ResponseField>

    <ResponseField name="disabledAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime</a>}>
      When the endpoint was disabled, or null if active.
    </ResponseField>

    <ResponseField name="disabledReason" type="String">
      Why the endpoint was disabled, or null if active.
    </ResponseField>

    <ResponseField name="id" type="ID!" required>
      The id of this webhook endpoint.
    </ResponseField>

    <ResponseField name="pendingSecretCreatedAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime</a>}>
      When a pending (staged, not-yet-activated) secret was created, if any.
    </ResponseField>

    <ResponseField name="secretSetAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime!</a>} required>
      When the current signing secret became active.
    </ResponseField>

    <ResponseField name="topics" type={<a href="/docs/api-reference/v3/reference/webhooks/webhook-topic">[WebhookTopic!]!</a>} required>
      Topics this endpoint is subscribed to.
    </ResponseField>

    <ResponseField name="updatedAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime!</a>} required>
      When the record was last updated.
    </ResponseField>

    <ResponseField name="url" type="String!" required>
      The URL deliveries are POSTed to.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```graphql theme={null}
query {
  webhookEndpoint(id: "...") {
    apiVersion
    createdAt
    description
    disabledAt
    disabledReason
    id
    pendingSecretCreatedAt
    secretSetAt
    # ...
  }
}
```
