The catalogue/SendGrid
SendGrid
app.sendgrid
SendGrid email delivery — send emails, manage contacts, lists, templates, and view statistics.
Version2.0.0
Categorycommunication
AuthAPI key
Tools16
Transportstdio
LicenceMIT
02
Tools
16 tools the agent can call.
Every one is declared with typed parameters and returns structured results, so the host can render them instead of narrating them.
- add-contactAdd or update contacts in SendGrid Marketing Campaigns (PUT /marketing/contacts). Accepts an array of contact objects with at least an email field.
- create-contact-listCreate a new contact list in SendGrid Marketing Campaigns (POST /marketing/lists). Returns the created list.
- delete-contact-listDelete a contact list from SendGrid Marketing Campaigns (DELETE /marketing/lists/{id}). This removes the list but does not delete the contacts in it.
- delete-contactsDelete one or more contacts from SendGrid Marketing Campaigns (DELETE /marketing/contacts?ids=...). Accepts an array of contact IDs.
- get-contactGet a specific contact by ID from SendGrid Marketing Campaigns (GET /marketing/contacts/{id}). Returns the full contact object.
- get-contact-listGet a specific contact list by ID from SendGrid Marketing Campaigns (GET /marketing/lists/{id}). Returns the list details including name, contact count, and metadata.
- get-statsGet global email statistics from SendGrid (GET /stats). Returns daily stats including requests, delivered, opens, clicks, bounces, etc. Requires a start_date in YYYY-MM-DD format.
- get-templateGet a specific transactional template by ID from SendGrid (GET /templates/{templateId}). Returns the template with its versions.
- list-contact-listsList all contact lists from SendGrid Marketing Campaigns (GET /marketing/lists). Returns { lists }.
- list-contactsList all contacts from SendGrid Marketing Campaigns (GET /marketing/contacts). Returns { contacts, contactCount }.
- list-sender-identitiesList all verified sender identities from SendGrid (GET /verified_senders). Returns { senders }.
- list-suppressionsList suppression entries from SendGrid (GET /suppression/bounces or /suppression/blocks). Specify the type of suppression to retrieve. Returns { suppressions }.
- list-templatesList dynamic transactional templates from SendGrid (GET /templates?generations=dynamic). Returns { templates }.
- search-contactsSearch contacts in SendGrid Marketing Campaigns using SGQL (POST /marketing/contacts/search). Example query: "email LIKE '%example.com' AND CONTAINS(list_ids, 'abc-123')". Returns { contacts, contactCount }.
- send-emailSend an email via SendGrid (POST /mail/send). The "from" address must be a verified sender identity. Provide at least one of textContent or htmlContent.
- validate-emailValidate an email address using SendGrid Email Validation (POST /validations/email). Returns validation result with verdict, score, and checks. Requires Email Validation on the SendGrid plan.
03
Auth and permissions
What it asks for.
Declared in the manifest, in advance. The app cannot reach anything it did not ask for here.
System secrets
API_KEY
Reading further
The manifest and the source for SendGrid live in the monorepo, alongside the other apps.