Start an OAuth authorization
Start connecting a provider through one of its auth schemes. Secret-form schemes return the new connection directly; OAuth schemes return a session and an authorization_url the user has to open in the browser. target_connection_id re-authorizes an existing connection; space_id records the Space the flow started from.
Authorization
bearerApiKey Create a scoped API key in the Adlass settings.
In: header
Header Parameters
Optional correlation identifier.
length <= 128A unique key for this intended write. Reuse it only for an identical retry.
1 <= length <= 200Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/integrations/authorizations" \ -H "Idempotency-Key: 123e4567-e89b-42d3-a456-426614174000" \ -H "Content-Type: application/json" \ -d '{ "provider_key": "klaviyo", "auth_scheme": "example", "label": "Customer documents" }'{ "connection": { "id": "123e4567-e89b-42d3-a456-426614174000", "provider_key": "klaviyo", "auth_scheme": "example", "label": "Customer documents", "external_identity": "example", "public_config": {}, "status": "ACTIVE", "enabled": false, "safe_error_code": "example", "test_summary": {}, "provider_contract_digest": "example", "last_tested_at": "example", "created_at": "example", "updated_at": "example", "setup_required": false, "offered_operations": [], "scope": {} }}