Skip to main content
POST
Create a group-level connection

Authorizations

Authorization
string
header
required

Authorization: Bearer <token>. Token types resolve to the same scoped credential: a user-generated API key (casa_…, from Account settings — recommended for machines and MCP clients), a WorkOS AuthKit session JWT (the web app; org and role come from verified token claims), or a static token. API keys are group-scoped, optionally pinned to one property at creation. MCP OAuth connector tokens authenticate the MCP server only and are rejected on these REST routes.

Body

application/json
provider
string
required
name
string
required
auth_type
string
required
description
string
logo_url
string<uri>

Response

Created (or refreshed, when the provider already had a connection).

data
object
required

A group-level integration connection (one per provider). Stored provider secrets are redacted; connection_metadata.has_credentials indicates whether credentials are stored.