Identities

List the caller's linked accounts

curl https://api.subscriby.net/v1/me/identities \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

Every account linked to the caller's creator account, by connector then purpose. Never paginated.

  • purpose is primary (the account that signs you in and receives alerts) or backup (the account registered for Disaster Recovery).
  • source says how the link was proven: handshake (you completed a link from Settings), bot (the account came in through the connector's own flow), backfill (migrated from before connectors), portal or adopted.
  • external_id is the platform's own id for the account, username its handle when the platform has one. Secrets and chat rows are never returned.

Linking has no endpoint. Linking is a two-sided proof: you open it from Settings → Security → Linked accounts and finish it from the account itself, by opening the link or sending the code to the connector's bot. A token cannot stand in for a person on the connector, so there is nothing to POST here.

get/v1/me/identities

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/me/identities
  • Auth: HTTP bearer

Response

Array of UserIdentityResource

Example response

{
  "data": [
    {
      "id": "0c2d8a7e-4b1f-4d3e-9a6b-2f5e8c1d7a90",
      "connector": "telegram",
      "purpose": "primary",
      "source": "handshake",
      "external_id": "123456789",
      "display_name": "Ada Lovelace",
      "username": "ada",
      "linked_at": "2026-09-12T10:05:00Z",
      "verified_at": "2026-09-12T10:05:00Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.