Connected accounts

The SendGrid accounts connected to the brand

The accounts an email block can send through, numbered the way its auth_id takes them with useAuth on. Each one is a sender address with the SendGrid API key that sends from it, and its name is that address. An empty list is answered by POST /connected-accounts/sendgrid/connections, a link a person in the brand opens to type the address and the key, not by anything a token does on its own.

Every account the brand has is listed, including ones added in the builder, so the same address can appear more than once; any of them sends from it. Landbot's own address for the brand is not listed: an email block with no auth_id already sends from it, and so does one whose auth_id is -1, which is what the builder writes when that address is picked. A block carrying -1 is a working block that sends from the brand's own address, not one naming an account that is gone: it needs no connection to send.

What comes back is the id and the name. Never the key: it stays where it is.

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

get/connected-accounts/sendgrid

Request

  • Base URL: https://api.landbot.io/v0-alpha
  • URL: https://api.landbot.io/v0-alpha/connected-accounts/sendgrid
  • 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.