AI workers for SendGrid

What is an AI worker for SendGrid?

An AI worker using SendGrid is an AI agent that can send email through your existing SendGrid account, which means its messages inherit the sending reputation, domain authentication, and deliverability setup your organisation has already built. It sends only where your permissions allow and only to recipients your contact rules permit.

What these workers do

Send a scheduled summary

Delivers a recurring digest to the people who asked for it, assembled from your connected systems and sent from your normal address.

Confirm a completed action

Emails the confirmation when something a customer was waiting for has finished, without a person needing to remember.

Deliver a requested document

Sends the report or record a person asked for, once it exists, from the domain they expect to hear from.

Follow up on an agreed timeline

Sends the promised message at the promised time, so commitments made in a conversation do not depend on memory.

How an AI worker runs in SendGrid

Sending through the pipe you already trust

Transactional, not campaigns

Your existing controls still apply

SendGrid questions, answered.

Does this use my existing sending domain and reputation?

Yes. The worker sends through your own SendGrid account, so your domain authentication, sending reputation, and bounce handling apply exactly as they do to everything else you send. It is not a new pipe alongside yours.

Do my suppression and unsubscribe lists still apply?

Yes, since it is the same account and the same configuration. On top of that, your contact rules are enforced before a message is handed over, so a recipient you have ruled out is refused at that point rather than depending on downstream suppression.

Should a worker send marketing campaigns?

No. This is for transactional messages a recipient expects. Bulk marketing has consent, preference, and unsubscribe requirements that belong in a system designed to manage them at scale, and a worker is the wrong instrument for it.

How much can it send?

Whatever your own SendGrid plan permits, though workers are generally set up to send small and predictable volumes. Sending is granted narrowly precisely because it is the one action that reaches real people, so a worker emailing thousands of recipients is a sign the job belongs in a different tool.

What AI workers can do in SendGrid

The tools a worker can be granted in SendGrid once you connect it. A kit grants only the ones its job needs, and you can narrow them further on the worker.

Send Message

Send a message through Messaging behind the WorkerKit firewall. Recipients are checked against the token's contact rules and the suppression/opt-out list before anything is sent (blocked → RECIPIENT_SUPPRESSED); the sender/channel must be permitted for this token. Provider support varies: scheduledAt and idempotencyKey are RESEND-only, mediaUrls TWILIO/RESEND-only, and 'from' is required for email providers — check providerCapabilities in the capabilities manifest.

Send Template Message

Send a Messaging template message with variable substitution. Discover template IDs with messaging_list_templates. The same firewall gates as messaging_send_message apply.

Dry-Run Send

Validate a Messaging send WITHOUT sending: runs every firewall gate (permissions, sender/channel scope, recipient contact rules, suppression list) and reports the verdict. Use before a real send to surface blocks early.

Preview Message

Preview a Messaging send WITHOUT sending: builds the message (template variables applied) and runs the same firewall gates as a real send, returning what would happen. Prefer messaging_dry_run_send when only the gate verdict matters.

Get Message Status

Get the delivery status of a Messaging message by the messageId returned from a send (status, recipient, timestamps, failure reason).

List Activity

List recent Messaging send activity (message metadata + delivery status; bodies are masked per the token's field visibility).

Get Stats

Get aggregate Messaging sending stats (volumes and outcome counters for the recent period). TWILIO and SENDGRID only; RESEND has no stats API.

List Senders

List the sender identities this Messaging connection can send from (a sender identity the connection can send from (see messaging_list_senders)). Use one of these as 'from'.

List Templates

List Messaging message templates available to this connection.

Get Template

Get a single Messaging template by ID.

Validate Recipient

Check whether a recipient address/number is valid and reachable via Messaging before sending. TWILIO only (Lookup).

Check Opt-Out

Check whether a recipient has opted out / is suppressed on Messaging. Sends to suppressed recipients are blocked automatically. SENDGRID only in v1.

List Suppressions

List recipients on the Messaging suppression list (opted-out / unsubscribed). SENDGRID only in v1.

Suppress Recipient

Add a recipient to the Messaging suppression list so future sends to them are blocked (records an opt-out). SENDGRID only in v1.

Unsuppress Recipient

Remove a recipient from the Messaging suppression list (higher-trust: only do this when the recipient asked to receive messages again). SENDGRID only in v1.

Cancel Scheduled Message

Cancel a scheduled Messaging message that has not been delivered yet, by the messageId the send returned. RESEND only in v1.

Send SendGrid Message

Send a message through SendGrid behind the WorkerKit firewall. Recipients are checked against the token's contact rules and the suppression/opt-out list before anything is sent (blocked → RECIPIENT_SUPPRESSED); the sender/channel must be permitted for this token. Attachments are not supported through WorkerKit — include links in the body instead.

Send SendGrid Template Message

Send a SendGrid template message with variable substitution. Discover template IDs with sendgrid_list_templates. The same firewall gates as sendgrid_send_message apply. Dynamic template IDs start with 'd-' (see sendgrid_list_templates).

Dry-Run SendGrid Send

Validate a SendGrid send WITHOUT sending: runs every firewall gate (permissions, sender/channel scope, recipient contact rules, suppression list) and reports the verdict. Use before a real send to surface blocks early.

Preview SendGrid Message

Preview a SendGrid send WITHOUT sending: builds the message (template variables applied) and runs the same firewall gates as a real send, returning what would happen. Prefer sendgrid_dry_run_send when only the gate verdict matters.

Get SendGrid Message Status

Get the delivery status of a SendGrid message by the messageId returned from a send (status, recipient, timestamps, failure reason). The messageId from a send is a request-level prefix that can match several per-recipient rows; the newest is returned with a matchedRecipients count. Requires the SendGrid Email Activity add-on.

List SendGrid Activity

List recent SendGrid send activity (message metadata + delivery status; bodies are masked per the token's field visibility). Covers the last 30 days. Requires the SendGrid Email Activity add-on and is heavily rate-limited upstream — call sparingly, never in a polling loop.

Get SendGrid Stats

Get aggregate SendGrid sending stats (volumes and outcome counters for the recent period). Aggregates the last 30 days of SendGrid account stats.

List SendGrid Senders

List the sender identities this SendGrid connection can send from (a verified sender address or any address on an authenticated domain (see sendgrid_list_senders)). Use one of these as 'from'.

List SendGrid Templates

List SendGrid message templates available to this connection.

Get SendGrid Template

Get a single SendGrid template by ID.

Check SendGrid Opt-Out

Check whether a recipient has opted out / is suppressed on SendGrid. Sends to suppressed recipients are blocked automatically.

List SendGrid Suppressions

List recipients on the SendGrid suppression list (opted-out / unsubscribed).

Suppress SendGrid Recipient

Add a recipient to the SendGrid suppression list so future sends to them are blocked (records an opt-out).

Unsuppress SendGrid Recipient

Remove a recipient from the SendGrid suppression list (higher-trust: only do this when the recipient asked to receive messages again). Removes a global unsubscribe only — bounce/spam records are never touched.