---
title: "Get plugin integration"
method: GET
path: "/plugin-integrations/{integrationId}"
tags: ["plugin-integrations"]
---

# Get plugin integration

`GET /plugin-integrations/{integrationId}`

Returns a single plugin integration by ID.

**OAuth2 isolation**: returns `404` if the integration was created by a different
OAuth2 application or by a public API access token (existence is masked for security).

## Path parameters

- `integrationId` string, uuid, required

## Response `200`

Plugin integration details

- object
  - `data` PluginIntegration, required — A plugin integration resource.
    - `id` string, uuid, required — Unique identifier for this plugin integration.
    - `type` 'pluginIntegration', required — Resource type identifier.
    - `createdAt` string, date-time, required — ISO 8601 timestamp when the integration was created.
    - `fields` PluginIntegrationResponseFields, required — Domain attributes returned in plugin integration responses. Note: `action` is intentionally absent — it contains a write-only authorization secret that is never returned by the API.
      - `type` string, required — Type identifier for the integration. Use your reversed domain name as a prefix to ensure global uniqueness (e.g., `com.example.myservice`). Integrations of the same type share the same icon and settings grouping in Productboard.
      - `name` string, required — Human-readable name shown as the column name on the Features board and in Productboard settings.
      - `integrationStatus` 'enabled' | 'disabled', required — Controls whether the integration is active: - `enabled` — integration column is visible and the push button is active - `disabled` — integration column is hidden from the Features board
      - `initialState` PluginIntegrationInitialState, required — Configuration of the push button before an entity has been connected to the third-party system.
        - `label` string, required — Label shown on the push button in its initial (unconnected) state.
    - `links` PluginIntegrationLinks, required — Links for this plugin integration resource.
      - `self` string, uri, required — URL to retrieve this plugin integration.
      - `connections` string, uri, required — URL to list all connections for this plugin integration.

## Other responses

- `400` — Bad Request - Invalid input format or malformed request
- `401` — Unauthorized - Missing or invalid authentication credentials
- `403` — Forbidden - Insufficient permissions
- `404` — Not Found - The requested resource does not exist or is not accessible
- `408` — Request Timeout - The server did not receive a complete request within the allowed time
- `429` — Too Many Requests - API rate limit exceeded, reduce request frequency and retry after the indicated time
- `500` — Internal Server Error - An unexpected error occurred on the server, please retry or contact support

---

[API](https://skmtc.dev/productboard/apis/notes.md) · [All operations](https://skmtc.dev/productboard/apis/notes/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/productboard/notes/revisions/b4004749b60f/schema)