Skip to main content
A webhook target is an HTTP endpoint that Plain delivers events to. Each target subscribes to one or more event types and is pinned to a specific webhook schema version.
For TypeScript, the GraphQL SDK gives you a fully typed client for these operations.
This section of the GraphQL API covers the management of webhook targets. How to register a new endpoint, change which events it receives, disable it temporarily, or inspect delivery attempts when something goes wrong. If you’re looking for the format of the events themselves, see Webhooks. These operations require the following permissions:
  • webhookTarget:create
  • webhookTarget:edit
  • webhookTarget:delete
The read queries require:
  • webhookTarget:read
Webhook targets can also be created and managed in the Plain app under Settings → Webhooks. Use the API when you want to provision targets as part of an infrastructure-as-code setup or to wire up environments programmatically.