> ## Documentation Index
> Fetch the complete documentation index at: https://docs.erdo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SetIntegrationIdentityAPI writes a connection's stored account identity
(account_id and, for


> Google Ads agency connections, the manager login\_customer\_id) into its encrypted credentials, leaving every other key untouched, and returns the summary in the GET /v1/integrations shape, never token material. It is the escape hatch the OAuth callback's auto-detection defers to, which stamps login\_customer\_id only when the sole accessible account is a manager. The session-only UpdateIntegration surface was the old way, leaving /v1 consumers unable to set the id a manager connection hard-requires or to backfill account\_id.




## OpenAPI

````yaml /api/openapi.json post /v1/integrations/{integrationID}/identity
openapi: 3.0.0
info:
  title: Erdo API
  description: >-
    Erdo's REST API: query and write datasets, run agents, manage threads,
    integrations, pages, evals, workstreams, experiments, and bounded outreach.
    Authenticate with a Bearer API key (erdo_api_...) or scoped token
    (erdo_token_...).
  version: '2026-11-21'
servers:
  - url: https://api.erdo.ai
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/integrations/{integrationID}/identity:
    post:
      summary: |
        SetIntegrationIdentityAPI writes a connection's stored account identity
        (account_id and, for
      description: >
        Google Ads agency connections, the manager login\_customer\_id) into its
        encrypted credentials, leaving every other key untouched, and returns
        the summary in the GET /v1/integrations shape, never token material. It
        is the escape hatch the OAuth callback's auto-detection defers to, which
        stamps login\_customer\_id only when the sole accessible account is a
        manager. The session-only UpdateIntegration surface was the old way,
        leaving /v1 consumers unable to set the id a manager connection
        hard-requires or to backfill account\_id.
      operationId: POST:mcp.SetIntegrationIdentityAPI
      parameters:
        - allowEmptyValue: true
          explode: false
          in: path
          name: integrationID
          required: true
          schema:
            format: uuid
            type: string
          style: simple
      requestBody:
        content:
          application/json:
            schema:
              properties:
                account_id:
                  type: string
                login_customer_id:
                  type: string
              type: object
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  account_id:
                    type: string
                  app:
                    type: string
                  auth_type:
                    type: string
                  connector_account_id:
                    description: >
                      Use it as connection\_id for provider lead sources; ID is
                      the distinct unified integration ID. Absent when no live
                      account could be resolved.
                    title: >
                      ConnectorAccountID is the live connector account in this
                      organization.
                    type: string
                  id:
                    type: string
                  identity_unchecked:
                    description: >
                      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.
                    title: >
                      IdentityUnchecked is set when the account could not be
                      looked up this
                    type: boolean
                  identity_unreadable:
                    description: >
                      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.
                    title: >
                      IdentityUnreadable is set when this connection's stored
                      credential could
                    type: boolean
                  login_customer_id:
                    type: string
                  mcp_header_names:
                    items:
                      type: string
                    type: array
                  mcp_url:
                    type: string
                  member_access:
                    description: >
                      may do: "read\_only" (the default) or "full". Set only on
                      connections made with one person's login (connected apps
                      and MCP servers such as GitHub); absent on org-wide native
                      connections, which the setting does not govern. The
                      connection's owner always has full access.
                    title: >
                      MemberAccess is what teammates reaching this connection
                      through a share
                    type: string
                  name:
                    type: string
                  provided_by_organization_id:
                    description: >
                      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.
                    title: >
                      ProvidedByOrganizationID and ProvidedByOrganizationSlug
                      are set only on a
                    type: string
                  provided_by_organization_slug:
                    type: string
                  provider_auth_failed_at:
                    description: >
                      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.
                    title: >
                      ProviderAuthFailedAt (RFC3339, absent when there is
                      nothing to report) is
                    type: string
                  status:
                    type: string
                  status_reason:
                    type: string
                  type:
                    type: string
                type: object
          description: Success response
        default:
          $ref: '#/components/responses/APIError'
components:
  responses:
    APIError:
      content:
        application/json:
          schema:
            externalDocs:
              url: https://pkg.go.dev/encore.dev/beta/errs#Error
            properties:
              code:
                description: Error code
                example: not_found
                externalDocs:
                  url: https://pkg.go.dev/encore.dev/beta/errs#ErrCode
                type: string
              details:
                description: Error details
                type: object
              message:
                description: Error message
                type: string
            title: APIError
            type: object
      description: Error response
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: An Erdo API key (erdo_api_...) or scoped token (erdo_token_...).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.