Skip to main content
POST
SetIntegrationIdentityAPI writes a connection's stored account identity

Authorizations

Authorization
string
header
required

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

Path Parameters

integrationID
string<uuid>
required

Body

application/json
account_id
string
login_customer_id
string

Response

Success response

account_id
string
app
string
auth_type
string
connector_account_id
string

Use it as connection_id for provider lead sources; ID is the distinct unified integration ID. Absent when no live account could be resolved.

id
string
identity_unchecked
boolean

time — the lookup failed before the stored credential was examined (a transient database failure, for instance). It is not a verdict on the credential: nothing is known to be wrong, and the remedy is to list again, never to reconnect. Kept apart from IdentityUnreadable so a blip is never reported as damage.

identity_unreadable
boolean

not be read back, so AccountID and LoginCustomerID are absent because we could not resolve them — not because the connection has no account recorded. Without it the two are the same empty field, and a caller acts on "this connection has no account" when the truth is "nobody can read this connection". Reported, never acted on: the connection is still listed, still usable where it works, and nothing here gates on it. The fix is a reconnect, which only the connection's owner can do.

login_customer_id
string
name
string
provided_by_organization_id
string

connection this organization reaches through a manager that lends it — the agency's own vendor key, usable here for as long as the management link lives. Absent on every connection the org holds itself. A caller that sees them should not offer to rotate or disconnect: the connection belongs to the manager, and only the manager can change it.

provided_by_organization_slug
string
provider_auth_failed_at
string

when the upstream provider last refused this connection's credential. Status cannot carry it: a retired key leaves a connection 'connected' here because Pipedream signs calls with it quite happily and simply returns the provider's 401 — which is how a widget on a customer's live site went two and a half days without anyone noticing. Reported, never acted on.

status
string
type
string