SendGrid
EmailAPI keyConnection test available
Send mail via the SendGrid v3 API (mail.send).
OCNORA ships 12 typed SendGrid operations. Each node has a schema-driven form, input and output tables beside its settings, and is pre-flighted by Workflow Health before your first real run.
Before you connect SendGrid
- Authentication
- API key
- Credential
- {"api_key": "…"}, or the API key on its own
- Connection test
- Available: the stored credential can be checked against the provider when you add it. This is not a record that a test was run or passed.
What you can do with SendGrid
Operations, grouped by what they do to your data.
Create and send 3
Delete and cancel 3
Nodes that use your SendGrid connection
Beyond its own nodes, these generic nodes accept your SendGrid credential. Each chooses the provider from the connection you select, so the same node also works with the other providers shown.
- Send Emailmail.sendSend an email through a SendGrid, SMTP, Hostinger, COAX Email API, Outlook or Gmail connection.
A sample SendGrid workflow
- 1A core triggerStart the run from a chat, form, manual, schedule, webhook, workflow trigger — no SendGrid trigger is needed.
- 2Get Listsendgrid.get_listFetch one marketing contact list by id, optionally with a sample contact.
- 3Create Listsendgrid.create_listCreate a marketing contact list with the given name.
An outline built from this provider’s node contracts, not a recorded run. Each step’s output fields are available to the next in the field picker.
Every node below has a reference page: what it does, the connection it needs, its config fields with types, constraints and examples, and the shapes it emits.
Operations 12
- Create ListCreate a marketing contact list with the given name.sendgrid.create_list
- Delete BounceRemove one address from the bounce suppression list so it can be mailed again.sendgrid.delete_bounce
- Delete ContactsQueue the deletion of marketing contacts by id, or of every contact in the account, and return the job id SendGrid assigns.sendgrid.delete_contacts
- Remove Global SuppressionTake one address off the global suppression list so SendGrid will deliver to it again.sendgrid.delete_global_suppression
- Get ListFetch one marketing contact list by id, optionally with a sample contact.sendgrid.get_list
- Get StatisticsFetch global email statistics for a date range, aggregated by day, week or month, together with the summed metrics across the range.sendgrid.get_stats
- List BouncesList bounced addresses on the suppression list, optionally within a Unix-timestamp window.sendgrid.list_bounces
- List ListsList the account's marketing contact lists, one page at a time.sendgrid.list_lists
- List Spam ReportsList addresses that reported a message as spam, optionally within a Unix-timestamp window.sendgrid.list_spam_reports
- Search ContactsSearch marketing contacts with an SGQL query and return the matching contacts, at most the first fifty.sendgrid.search_contacts
- Send MailSend one message through the SendGrid v3 mail send API, with optional cc/bcc, reply-to, categories, attachments, a dynamic template and a scheduled send time.sendgrid.send_mail
- Add or Update ContactsQueue an add-or-update of marketing contacts, optionally adding them to one or more lists, and return the job id SendGrid assigns.sendgrid.upsert_contacts
Templates that use SendGrid
- Inbox triage: classify and route emailEvery 15 minutes, fetch the next unread email, classify it (urgent / billing / general) and route urgent ones to the on-call inbox with an auto-acknowledgement.
- AI support agent with order lookupA webhook hands a customer message to a tool-using agent that can look up the order over HTTP, then the answer is emailed back.
- AI screen, human approve, then sendClassify an inbound request, ask a reviewer to approve or reject it, and email the requester the outcome.
- Welcome e-mail for a new HubSpot contactWhen a contact is created in HubSpot, read it back and send a personalised welcome e-mail.
- First notice of loss: extract, validate, triageA claim notification arrives by webhook; AI extracts the loss details, the payload is validated, an adjuster triages it and the claim is opened in Iris.
- Scheduled health check with email alertPing an endpoint every 5 minutes; if it does not return 200, email the on-call address with the status code.
- Sales inbox: qualify and routePoll the sales mailbox, classify each email as lead / existing customer / vendor, create Iris records for new leads and forward the rest to the right team.
- Weekly Salesforce pipeline digestRun a SOQL query against open opportunities every Monday and e-mail the result to the sales lead.
- Daily spreadsheet summary by e-mailRead a range from a Google Sheet every morning and e-mail the rows to a distribution list.
- Stripe payment failure alertA failed Stripe payment reaches the billing channel and the billing inbox with the customer already looked up.
- Delay, retry and dead-letterCall a flaky endpoint with backoff retries; on final failure wait, try a fallback endpoint, and if that also fails email an operator.
- Scheduled API digest by emailEvery weekday morning pull a JSON summary from your API, have an LLM turn it into three bullet points and email the team.
Where SendGrid fits
Solutions
SendGrid questions
- How does OCNORA authenticate with SendGrid?
- With a stored API key credential, shaped {"api_key": "…"}, or the API key on its own. A connection test can check it when you add it.
- What can I automate with SendGrid?
- 12 typed operations, each with a reference page listing its config fields and the shapes it emits. The credential also drives 1 generic node.
- What if the SendGrid operation I need is not listed?
- Where SendGrid has an HTTP API, call it from the HTTP node with the same credential, or describe the step to the AI builder, which asks our team for a typed node when one is missing.
- Are there templates that use SendGrid?
- Yes: 12 templates, listed above.
- How are SendGrid calls controlled?
- Every call and every run step is audited, runs count against the execution budget, and Workflow Health pre-flights the workflow when you save it.
See your first SendGrid workflow run.
Book a technical demo. We add the connection, pick a template or describe the workflow to Build with AI, and Workflow Health checks it before it runs.