Skip to main content
POST
Create a connect link

Authorizations

Authorization
string
header
required

A scoped Integration key, prefixed cint_. Send as Authorization: Bearer cint_... on every request. Server-side only. Legacy personal cmem_... keys remain accepted during migration; team/org-scoped cmem_... keys are not valid on this API.

Body

application/json
endUserId
string
required

Your stable internal user ID. No colon allowed.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9@._-]{1,128}$
Example:

"u_123"

type
string
required

Data-source type id. Any source-capable type in the connector catalog (~200 sources — Gmail, Slack, HubSpot, Notion, Linear, Salesforce, warehouses, …); enumerate them via GET /api/v1/connectors/catalog.

Pattern: ^[a-z0-9][a-z0-9_-]{0,63}$
Example:

"hubspot"

redirectUrl
string<uri>

Absolute http(s) URL in YOUR app where the user lands after consent. Defaults to a neutral Conare page when omitted.

collections
string[]

Collection ids to sync for this source (see GET /api/v1/connectors/{type}/collections). Omit to sync every collection the source exposes. For Slack this selects channels.

The connector data policy applies either way: CRM attachment and audit/history collections are refused, credential/secret and bank/tax/government-ID fields are excluded, and backfill is capped at the last 24 months of activity (current CRM accounts, contacts and opportunities are always included regardless of age).

Required array length: 1 - 100 elements

Response

Hosted consent link minted.

success
boolean
required
url
string<uri>
required

Single-use hosted consent URL. Send the end user here.

type
string
required

Data-source type id. Any source-capable type in the connector catalog (~200 sources — Gmail, Slack, HubSpot, Notion, Linear, Salesforce, warehouses, …); enumerate them via GET /api/v1/connectors/catalog.

Pattern: ^[a-z0-9][a-z0-9_-]{0,63}$
Example:

"hubspot"