Files
magnus919_agent-skills/email/references/00-source-index.md
Magnus HedemarkGitHubfactory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
3256a87bcb feat(skill): add collaboration & business-app tool layer (Slack, Notion, email, CRM, payments) (#269)
Adds five top-level operational tool skills, one per named tool:

- slack: messages, channels, threads, search, files, and webhook signature
  verification (HMAC-SHA256) via a bounded, stdlib-only slack-cli.
- notion: pages, database queries, search, and guarded page updates via
  notion-cli.
- email: transactional email via Twilio SendGrid (send, deliverability
  bounces/spam reports, Signed Event Webhook verification with a
  self-contained ECDSA P-256 verifier) via email-cli.
- crm: HubSpot CRM records, contact search, and deal pipeline views with
  guarded stage updates via crm-cli.
- stripe: read-only-first balance, payment, and subscription queries with
  a guarded period-end subscription cancellation via stripe-cli.

Each skill ships an executable script (--json output, --limit bounded reads,
--dry-run/--yes mutation gate), a human README with the five required
sections, a schema-v1 evals/evals.json with six output-quality cases, a dated
source index + operations reference, and a deterministic unittest suite run
by check-artifacts. All five are indexed in the top-level README and the
generated catalogs were regenerated. Eval coverage rises from 78/139 to
83/144.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
2026-08-03 20:19:26 -04:00

1.6 KiB

Email (SendGrid) — Source Index

Last Updated: 2026-08-03

This skill is a distilled operating layer over Twilio SendGrid's public developer documentation. Facts and endpoint names in this skill are grounded in the sources below; refresh this index when SendGrid ships API changes.

Topic Source URL
SendGrid v3 API reference Twilio SendGrid API v3 reference https://www.twilio.com/docs/sendgrid/api-reference
Send email Send Mail API https://www.twilio.com/docs/sendgrid/api-reference/mail-send/mail-send
Suppressions (bounces, spam reports) Suppressions API https://www.twilio.com/docs/sendgrid/api-reference/suppressions
Signed Event Webhook (signature verification) Event Webhook security features https://www.twilio.com/docs/sendgrid/for-developers/tracking-events/getting-started-event-webhook-security-features
Event Webhook payload reference Event webhook reference https://www.twilio.com/docs/sendgrid/for-developers/tracking-events/event
Official Python verification helper sendgrid-python eventwebhook https://github.com/sendgrid/sendgrid-python/tree/main/sendgrid/helpers/eventwebhook

Refresh procedure

  • Re-check the signed-webhook security page before changing anything in webhook verify; the ECDSA signing scheme is a security boundary and the official Python helper is the reference implementation this skill mirrors.
  • Re-check the Mail Send API when SendGrid announces breaking changes to the /v3/mail/send payload.
  • Update research_checked in SKILL.md frontmatter and this file's Last Updated when you verify the sources again.