Relationship Intelligence

Sources to connect

Sources to connect lists Google, Slack, and HubSpot. The page names each source and offers Connect for Google and HubSpot when no account is connected.

get/v1/relationship-sources

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /v1/relationship-sources
  • Auth: HTTP bearer

Response

Sources to connect.

Example response

{
  "sources": [
    {
      "accounts": [
        {
          "authorizationStartedAt": "2026-07-31T13:00:00Z",
          "authorizedAt": "2026-07-31T13:01:00Z",
          "backfillCompleted": 250,
          "backfillCompletedAt": "2026-07-31T13:10:00Z",
          "backfillPhase": "live",
          "backfillTotal": 1000,
          "completeness": "partial",
          "connectionId": "6b8dfa9b-a7b2-46ea-982c-622a914c00e5",
          "consentingActorId": "a8dfa9b6-a7b2-46ea-982c-622a914c00e5",
          "disconnectedAt": "2026-07-31T14:00:00Z",
          "errorCode": "rate_limited",
          "expectedCadenceSeconds": 900,
          "grantedScopes": [
            "https://www.googleapis.com/auth/gmail.readonly"
          ],
          "lagSeconds": 42,
          "lastError": "Provider synchronization is delayed.",
          "lastFailedSyncAt": "2026-07-31T14:00:00Z",
          "lastObservationAt": "2026-07-31T13:58:00Z",
          "lastProviderEventAt": "2026-07-31T13:58:00Z",
          "lastSuccessAt": "2026-07-31T14:00:00Z",
          "lastSyncAt": "2026-07-31T14:00:00Z",
          "missingScopes": [
            "https://www.googleapis.com/auth/gmail.send"
          ],
          "nextRetryAt": "2026-07-31T14:05:00Z",
          "requiredScopes": [
            "https://www.googleapis.com/auth/gmail.readonly"
          ],
          "retryCount": 2,
          "revokedAt": "2026-07-31T14:00:00Z",
          "source": "google",
          "sourceAccountId": "me@company.com",
          "status": "live",
          "syncStartedAt": "2026-07-31T13:01:00Z"
        }
      ],
      "actions": [
        "gmail_send"
      ],
      "connectPath": "/v1/google-oauth/start",
      "disconnectPath": "/v1/google-oauth",
      "displayName": "Google Gmail & Calendar",
      "evidence": [
        "email_threads"
      ],
      "expectedCadenceSeconds": 900,
      "readScopes": [
        "https://www.googleapis.com/auth/gmail.readonly"
      ],
      "scopeExplanation": "Read scopes build relationship history.",
      "source": "google",
      "supportsReconnect": true,
      "supportsResync": true,
      "writeScopes": [
        "gmail.send"
      ]
    }
  ]
}

Changes

No operation changes recorded.