Skip to main content
POST
ConnectIntegrationAPI mirrors erdo_connect_integration, including remote MCP

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.

credentials_from_integration_id
string

current credential the caller supplied, in any organization. A key in a never-viewable field cannot be read back through the product, so this is how an agency lends a vendor key connected inside one client to others. The integration service owns every bound (verified current supplier, key-authenticated, active, same app); this surface adds that no credentials may accompany it, no rotation, and a native config. Like ManagedAccess it carries no jsonschema tag and handleConnectIntegration clears it, so a model cannot take a credential into another organization; REST and CLI, which a person drives, honour it.

integration_id
string
managed_access
string

only on the native credential path: a Pipedream connection is not an integration row this column lives on, and an OAuth grant is a named person's account that must not be spent on another business's behalf. Both are refused rather than ignored, since silence would make the caller believe clients could use the key. It carries no jsonschema tag and handleConnectIntegration clears it before the logic runs, so no MCP caller can set it: widening which organizations a credential serves is not a decision a model should take.

mcp_headers
MCPHeaders are static authentication headers, encrypted at rest and omitted · object

from readback. Rotation replaces the whole map; an empty map removes them.

mcp_url
string

required, except literal loopback HTTP in local development.

member_access
string

for writes. Visibility is granted separately by share_with_org.

name
string
refresh_tools
boolean
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.

rotate_credentials
boolean

instead of adding a second one. A rotated key must land on the connection everything else already references — a sibling connection leaves every pinned widget, automation and shared grant pointing at the dead key.

scopes
string[]
share_with_org
boolean

instead of the default private-to-the-connector. A credential connected headlessly is usually org infrastructure (a customer org's calendar, a shared SaaS key) that teammates and org agents must be able to see and build on — private-by-default is right for a personal OAuth grant, wrong for that.

Response

Success response

app
string
connect_url
string
integration_id
string
mcp_header_names
string[]
next_step
string
organization_name
string
organization_slug
string
status
string