Connected accounts

The Google accounts connected to the brand

The accounts a google_spreadsheets block can go through, numbered the way its auth_id takes them. Each one is a Google account somebody connected to the brand. Connecting one is a consent a person gives at Google in the browser, and this API starts it: POST /connected-accounts/google_spreadsheets/connections answers a link a member of the brand opens in the app, and GET .../connections/{id} says when the account is connected and which one it is. So an empty list is answered by starting a connection and handing the link to a person in the brand, not by anything a token does on its own.

Two kinds of account are not listed, because the builder offers them nowhere: one that was revoked, and one connected with the scopes the app no longer accepts, which the app asks to be reconnected. Connecting the same Google account again, in the app or through a connection, makes it appear here with the id it already had.

What comes back is the id and the name. Never a token: the credential stays where it is.

What the block names below the account — the file, the tab and its columns — is read through it by the operations below, with the same credential.

Needs the permission to view integrations, as the API the builder goes through does.

get/connected-accounts/google_spreadsheets

Request

  • Base URL: https://api.landbot.io/v0-alpha
  • URL: https://api.landbot.io/v0-alpha/connected-accounts/google_spreadsheets
  • Auth: one of:
    • API key in header Authorization
    • API key in cookie sessionid
    • HTTP bearer

Response

The accounts, most recently connected first

Example response

{
  "data": [
    {
      "id": 7,
      "name": "sheets@example.com"
    }
  ]
}

Changes

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