Skip to main content
POST
ConnectIntegrationAPI mirrors the erdo_connect_integration MCP tool.

Authorizations

Authorization
string
header
required

An Erdo API key (erdo_api_...) or scoped token (erdo_token_...).

Body

application/json
app
string
credentials
Credentials is caller-supplied secret material (DB passwords, API keys, · object

service-account JSON). encore:"sensitive" keeps it out of request trace storage — the same treatment integration.CreateIntegrationRequest.Credentials gets.

name
string
return_url
string

authorization at connect_url. Only meaningful for OAuth apps (native OAuth and Pipedream) that hand back a connect_url. Empty returns the user to Erdo's data page — the default for MCP/CLI callers with no product origin of their own; a portal built on /v1 passes its own page so the operator lands back on it. Must be an absolute http(s) URL with no embedded credentials.

scopes
string[]

Response

Success response

app
string
connect_url
string
integration_id
string
next_step
string
status
string