El catálogo/SendGrid

SendGrid

app.sendgrid

SendGrid email delivery — send emails, manage contacts, lists, templates, and view statistics.

Clave de APIcommunicationLeer el código
Versión2.0.0
Categoríacommunication
AutenticaciónClave de API
Herramientas16
Transportestdio
LicenciaMIT
02

Herramientas

16 herramientas que el agente puede llamar.

Todas se declaran con parámetros tipados y devuelven resultados estructurados, así que el anfitrión puede renderizarlas en vez de narrarlas.

  • 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

Autenticación y permisos

Qué pide.

Declarado en el manifiesto y por adelantado. La aplicación no puede alcanzar nada que no haya pedido aquí.

Secretos de sistema

API_KEY

Seguir leyendo

El manifiesto y el código de SendGrid están en el monorepo, junto al resto de aplicaciones.

Leer el códigoVolver al catálogo

SendGrid · Agent Apps