SendGrid Tools

SendGrid is an email delivery and marketing platform. Use these tools in a workflow to send transactional emails and to add, update, or list marketing contacts in your SendGrid account.

Overview

Operations

Configuration

sendgrid_send_email

Sends a plain-text email. Calls POST https://api.sendgrid.com/v3/mail/send.

sendgrid_add_contact

Adds or updates a marketing contact (upsert by email). Calls PUT https://api.sendgrid.com/v3/marketing/contacts.

sendgrid_list_contacts

Lists marketing contacts. Calls GET https://api.sendgrid.com/v3/marketing/contacts.

Outputs

sendgrid_send_email

• data (json) — Send status. Returns { "status": "sent" } on success.
• metadata (json) — Response metadata.
  • statusCode (number) — HTTP status code.

sendgrid_add_contact

• data (json) — The SendGrid contact job response (the parsed JSON body returned by SendGrid).
• metadata (json) — Response metadata.
  • statusCode (number) — HTTP status code.

sendgrid_list_contacts

• data (json) — Array of SendGrid contact objects (the result array from the API response).
• metadata (json) — List metadata.
  • count (number) — Number of contacts returned.

YAML Example

sendgrid_1:
  type: sendgrid
  name: "SendGrid"
  inputs:
    operation: "sendgrid_send_email"
    to: "recipient@example.com"
    from: "sender@yourdomain.com"
    subject: "Welcome to Zelaxy"
    content: "Thanks for signing up. Your workflow is live."
    apiKey: "{{SENDGRID_API_KEY}}"
  connections:
    outgoing:
      - target: next-block-id

Tips

• Auth setup: Create an API key in the SendGrid dashboard (Settings → API Keys) with at least Mail Send and Marketing permissions, then store it as an environment variable and reference it as {{SENDGRID_API_KEY}}. The key is sent as Authorization: Bearer <apiKey>.
• The from address for sendgrid_send_email must be a verified sender or belong to a verified domain in SendGrid, otherwise the send is rejected.
• sendgrid_add_contact is an upsert: passing an existing email updates that contact rather than creating a duplicate. SendGrid processes this asynchronously, so data contains a job reference rather than the final contact record.
• sendgrid_send_email only supports a single recipient and plain-text bodies; for HTML, multiple recipients, or templates use the SMTP block or a custom HTTP request.