COcomposal
organizations

Connect a third-party signal source (organization admin only)

Creates the integration and stores the supplied credentials as organization-scoped secrets. The response carries the inbound_url to paste into the provider's webhook configuration.

post/api/v1/organizations/{organization_id}/signal_integrations

Request

  • Base URL
    https://composal.com (the document declares no server; this is the origin it was published from)
  • URL
    https://composal.com/api/v1/organizations/{organization_id}/signal_integrations
  • Auth
    HTTP bearer

Path parameters

organization_idstring required

Request body

provider'sentry' | 'planetscale' required
mode'connected' | 'managed'

connected is a customer-owned credential pasted into Vex; managed is a Vex-provisioned resource where Vex already holds the credential.

namestring required
webhook_secretstring

The provider's signing secret. Stored as an organization secret; never read back.

api_tokenstring

Optional provider API token for target discovery and backfill.

configobject

Response

The signal integration

Changes

No recorded changes to this operation across all 3 revisions of this API.