v1

latestOpenAPI 3.1.1Productboard Proprietary2026-07-2453178243.2 KB
webhooks

Create webhook subscription

Creates a new webhook subscription to be actively notified on each change in the specified entities.

As part of subscription creation, Productboard validates the notification URL: it must use https, have a publicly resolvable host, and not point to localhost, loopback, site-local, or internal addresses.

Scope requirements: the OAuth2 application must have the scopes required by all requested event types.

post/webhooks

Request body

Example request

{
  "data": {
    "fields": {
      "name": "Feature changes webhook",
      "notification": {
        "url": "https://example.destination.com/webhooks-handler",
        "version": 1,
        "headers": {
          "authorization": "Bearer myWebhookSecret"
        }
      }
    }
  }
}

Response

Webhook subscription created successfully

Example response

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "webhook",
    "links": {
      "self": "https://api.productboard.com/v2/webhooks/550e8400-e29b-41d4-a716-446655440000"
    }
  }
}