Sign in

v18

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014211,6201.8 MB
gitpod.v1.IntegrationService

CreateIntegration

Creates a new integration instance within an organization.

Use this method to:

  • Instantiate an integration for an organization
  • Configure integration-specific settings
  • Enable integration capabilities
post/gitpod.v1.IntegrationService/CreateIntegration

Request body

categoriesGitpodV1IntegrationCategory[]

categories classifies this integration for filtering and display

descriptionstring

description is the description for custom integrations.

enabledboolean

enabled indicates if this integration is enabled

hoststring

host is the hostname for this integration (e.g., "linear.app") - optional, derived from MCP URL for custom integrations

integrationDefinitionIdstring

integration_definition_id references the integration definition ID. Optional for custom integrations — when empty, name and host are required.

namestring

name is the display name for custom integrations. Required when integration_definition_id is empty.

runnerIdstring uuid

runner_id is optional and immutable - if provided, restricts integration to specific runner

Response

Success