Docs Navigation

Blocks

SendGrid

Send emails and manage contacts with SendGrid.

Connect to SendGrid API v3 to send transactional emails, use dynamic templates, and manage marketing contacts.

Back to Catalog

Toolssendgrid

Block Preview

SendGrid

Send emails and manage contacts with SendGrid.

Usage

Add the block to your workflow and connect it to the upstream step.
Configure any required credentials or tokens in the inputs.
Fill in required inputs and optional parameters for the run.
Run a test execution, inspect outputs, and iterate before deploying.
Deploy the sendgrid block with monitoring enabled in production.

Inputs (UI)

API Key

short-input

Placeholder: SG.xxxxxxxx

Layout: full

Operation

dropdown

Layout: full

Options: Send Email, Send Template Email, List Contacts, Add Contact

From Email

short-input

Placeholder: sender@example.com

Layout: half

Condition: operation = ["send_email","send_template"]

From Name

short-input

Placeholder: Sender Name

Layout: half

Condition: operation = ["send_email","send_template"]

To Email(s)

short-input

Placeholder: recipient@example.com (comma-separated for multiple)

Layout: full

Condition: operation = ["send_email","send_template"]

Subject

short-input

Placeholder: Email subject line

Layout: full

Condition: operation = "send_email"

HTML Content

code

Placeholder: <h1>Hello!</h1><p>Your message here...</p>

Layout: full

Condition: operation = "send_email"

Plain Text (optional)

long-input

Placeholder: Plain text version of your email

Layout: full

Condition: operation = "send_email"

Template ID

short-input

Placeholder: d-xxxxxxxxxxxxxxxx

Layout: full

Condition: operation = "send_template"

Template Data (JSON)

code

Placeholder: {"name": "John", "orderNumber": "12345"}

Layout: full

Condition: operation = "send_template"

Contact Email

short-input

Placeholder: contact@example.com

Layout: full

Condition: operation = "add_contact"

First Name

short-input

Placeholder: John

Layout: half

Condition: operation = "add_contact"

Last Name

short-input

Placeholder: Doe

Layout: half

Condition: operation = "add_contact"

Inputs (API)

operation

string

Required

apiKey

string

Required

to

string

Optional

from

string

Optional

fromName

string

Optional

subject

string

Optional

htmlContent

string

Optional

textContent

string

Optional

templateId

string

Optional

dynamicTemplateData

json

Optional

email

string

Optional

firstName

string

Optional

lastName

string

Optional

Outputs

Primary response type:

{
  "success": "boolean",
  "messageId": "string",
  "data": "any"
}

Tool Access

sendgrid_send