Skip to main content
POST
Execute an action

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.

Headers

Idempotency-Key
string
required

Stable key for this logical upstream mutation. Reuse it only when retrying the exact same request.

Optional stable source-event key.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{0,199}$

Path Parameters

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"

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"

method
enum<string>
required
Available options:
POST,
PUT,
PATCH,
DELETE
path
string
required

Provider-relative path without query or fragment. Use query or rawQuery for query parameters.

Maximum string length: 2048
Pattern: ^/(?!/)
query
object
rawQuery
string

Exact encoded query fragment without a leading ?.

Maximum string length: 4096
headers
object

Optional provider headers. Authentication, host, cookie, content length, connection, transfer-encoding, and every header blocked by the live connection contract are rejected.

body

JSON object, string, or null; maximum 262144 UTF-8 bytes.

Response

Provider call completed; inspect the enclosed provider response.

success
boolean
required

True when the provider returned a 2xx status.

actionId
string | null
required

Audit correlation id for this provider call.

response
object
required