twilio-sendgrid-engagement-quality

Monitor SendGrid email deliverability using Engagement Quality scores and metrics.

5.3k|765|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/openai/plugins --skill twilio-sendgrid-engagement-quality
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: twilio-sendgrid-engagement-quality
Source: https://github.com/openai/plugins/tree/main/plugins/twilio-developer-kit/skills/twilio-sendgrid-engagement-quality
Command: npx skills add https://github.com/openai/plugins --skill twilio-sendgrid-engagement-quality

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests.

What problem does it solve?

Diagnosing why SendGrid emails land in spam folders is difficult without visibility into sender reputation. This Skill provides structured guidance for querying SendGrid Engagement Quality (SEQ) scores so you can measure how wanted your email is and pinpoint which deliverability factors need improvement.

Core Features & Use Cases

  • SEQ Score Retrieval: Query the /v3/engagementquality/scores endpoint for date-range scores and the subusers endpoint for per-subuser daily scores, with pagination support.
  • Five-Metric Interpretation: Understand engagement_recency, open_rate, bounce_classification, bounce_rate, and spam_rate scores (1-5 scale) and the concrete actions that improve each one.
  • Eligibility & Limit Handling: Know the prerequisites (Pro/Premier plan, open tracking enabled, 1,000+ messages in 30 days) and constraints (90-day lookback, asynchronous 202 responses, opaque score weighting).
  • Use Case: Your open rates dropped and inbox placement declined. Use this Skill to pull your SEQ scores for the past month, identify that bounce_rate fell to 2, and follow the guidance to clean your list and implement double opt-in.

Quick Start

Ask the assistant to fetch my SendGrid Engagement Quality scores for the last 30 days and explain which metrics are hurting my deliverability.

Frequently Asked Questions about twilio-sendgrid-engagement-quality

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my SendGrid Engagement Quality score?

Send a GET request to /v3/engagementquality/scores with from and to date parameters (YYYY-MM-DD, UTC) and your SendGrid API key as a Bearer token. The response returns daily overall scores plus the five individual metrics.

What are the SendGrid SEQ eligibility requirements?

You need a Pro or Premier Email API plan, open tracking enabled in SendGrid settings, and at least 1,000 messages sent in the previous 30 days. If any condition is unmet, the score and metrics fields are omitted from API responses.

Why does the SendGrid SEQ API return a 202 response?

A 202 response means scores are calculated asynchronously and are not yet available for the requested date. Retry the request later; scores are computed daily rather than in real time.

Does SendGrid Engagement Quality work with the Twilio Email API?

No. SEQ requires a SendGrid API key with the SG- prefix and is not applicable to the Twilio Email API at comms.twilio.com. It only works with SendGrid Email API accounts on Pro or Premier plans.

How far back can I query SendGrid engagement scores?

The SEQ API limits queries to the last 90 days. The subuser scores endpoint accepts only a single date per request, so you must query one day at a time for subuser-level data.

Is the overall SEQ score an average of the five metrics?

No. The overall score is not a simple average of engagement_recency, open_rate, bounce_classification, bounce_rate, and spam_rate. The weighting formula is not published, and one low metric can significantly drag down the overall score.