APIReferenceIntegrations
Connect an integration
Stores non-secret config on the integration row and the API key in Vault.
Stores non-secret config on the integration row and the API key in Vault.
Authorization
bearerAuth AuthorizationBearer <token>
A Supabase Auth user access token for the signed-in SignalDock user, sent as Authorization: Bearer <token>. Paste one from a signed-in session, or obtain one through the oauth2 scheme; the API accepts either.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
curl -X POST "https://example.com/integrations/connect" \ -H "Content-Type: application/json" \ -d '{ "organizationId": "7bc05553-4b68-44e8-b7bc-37be63c6d9e9", "provider_key": "overheid", "kind": "crm", "secret": "string" }'{ "id": "99999999-9999-4999-8999-999999999999", "organization_id": "33333333-3333-4333-8333-333333333333", "provider_key": "overheid", "kind": "crm", "status": "connected", "config": { "property1": null, "property2": null }, "mapping": { "property1": null, "property2": null }, "created_at": "2026-09-15T12:00:00.000Z", "updated_at": "2026-09-15T12:00:00.000Z"}