Connected accounts

Ask a person to connect a SendGrid account

The same as for Google Sheets, with a form where the consent would be: it answers a url that a member of the brand opens, signed in to the app, to see who asked and type the sender's email address and a SendGrid API key. The key is checked with SendGrid before anything is kept, and it never travels through this API. When they finish, a SendGrid account is connected to the brand, and the connection below says which one it is.

The key has to be able to send mail, which is SendGrid's Mail Send permission. The sender has to be verified in that SendGrid account, and that is not checked: SendGrid refuses an unverified sender when the mail is sent. The accounts already connected are listed by GET /connected-accounts/sendgrid: start a connection only when none of them will do. Connecting a sender the brand already has replaces its key and keeps its id, so a block that names it keeps working.

The link lives fifteen minutes and is answered once. Hand it to a person in the brand who may edit integrations: anyone else is refused at the page, and so is a link already answered. Then poll the connection every few seconds; there is no push.

Takes no body. Needs the permission to edit integrations, as connecting an account in the app does.

post/connected-accounts/sendgrid/connections

Request

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

Response

The connection, and where it is followed

Example response

{
  "data": {
    "id": "2c7e9d10-3b4f-4c5a-8e6d-9f0a1b2c3d4e",
    "url": "https://app.landbot.io/integrations/google/spreadsheets/connect/2c7e9d10-3b4f-4c5a-8e6d-9f0a1b2c3d4e/",
    "expires_at": "2026-09-16T09:18:19"
  }
}

Changes

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