Create plugin integration

post

https://api.productboard.com/v2/plugin-integrations

Creates a new plugin integration. As part of creation, Productboard sends a probe request (GET) to your configured action URL to verify it is reachable and intends to receive action notifications. See the callbacks section below.

The integration is created in the enabled state by default. Set fields.integrationStatus to disabled to skip the probe (useful for staged setup).

action is write-only: the action configuration, including any headers.authorization secret, is never returned in responses.

Responses

Callbacks

Language

Credentials

Bearer

JWT

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Plugin integration created successfully

400Bad Request - Invalid input format or malformed request

401Unauthorized - Missing or invalid authentication credentials

403Forbidden - Insufficient permissions

408Request Timeout - The server did not receive a complete request within the allowed time

422Unprocessable Entity - Validation failed (e.g., missing required fields, unknown fields)

429Too Many Requests - API rate limit exceeded, reduce request frequency and retry after the indicated time

500Internal Server Error - An unexpected error occurred on the server, please retry or contact support