Messaging

SendGrid

target_app: "sendgrid" · endpoint /v1/messaging/execute · Bring your own credentials

Setup

Create an API key in SendGrid → Settings → API Keys, and verify a sender email/domain (SendGrid rejects sending from unverified addresses).

Credentials needed on your Connections page

api_key — API Key. Find it: SendGrid → Settings → API Keys

from_email — From Email. Find it: Must be a Verified Sender in SendGrid

Actions

send_email

Send an email — html is optional; if omitted, plain text is sent.

Request body:

{
  "user_id": "...",
  "action": "send_email",
  "payload": { "to": "user@example.com", "subject": "Hi", "text": "Plain fallback", "html": "<b>Hi</b>" },
  "target_app": "sendgrid"
}

provider_response.result shape:

{} (SendGrid returns 202 with an empty body on success)

Anticipated errors & fixes

403 "The from address does not match a verified Sender Identity"

Cause: from_email is not verified in your SendGrid account.

Fix: SendGrid → Settings → Sender Authentication → verify that exact email or domain.

401 Unauthorized (inside provider_response)

Cause: API key is wrong or was deleted.

Fix: Generate a new key with "Mail Send" permission and update your Connections page.

401 "Unauthorized: Invalid API key."

Cause: Your eConnect Authorization header is missing, malformed, or the key was regenerated/revoked.

Fix: Copy your api_key fresh from the eConnect dashboard and confirm the header reads exactly "Authorization: Bearer <key>".

429 "Too many requests"

Cause: You've exceeded your plan's per-minute rate limit.

Fix: Wait a minute and retry, or upgrade your plan for a higher per-minute limit.

429 "Monthly API limit exceeded"

Cause: You've used your plan's full monthly request allowance.

Fix: Wait for your next billing cycle reset, or upgrade to a plan with a higher monthly limit.

← Back to all platforms