Objective
To guide customers on how to implement the Gmail Feedback-ID header using Twilio Email, and how to use Gmail Postmaster Tools to monitor feedback and deliverability.
Product
Twilio SendGrid Email
User Account Permission/Role(s) Required
Primary administrator or Teammate with administration permissions.
Procedure
Understanding Feedback-ID:
The Feedback-ID header is a Gmail-specific header that helps identify and troubleshoot deliverability issues by associating feedback (such as spam complaints) with specific campaigns or customer segments. For more details, see the official Gmail documentation: Gmail Feedback-ID Header.
Adding the Feedback-ID Header in Twilio Email UI
• When sending emails via Twilio Email, you can add custom headers to your messages.
• To add the Feedback-ID header In your email sending code or integration, add the following header:
Feedback-ID: <custom-string>• Replace <custom-string> with a value that helps you identify the campaign, customer, or message type (e.g., Campaign123.User456.Prod).
If using the Email API, include the header in the headers object of your API request. Example (for the v3 Mail Send API):
json
{
"personalizations": [...],
"from": {...},
"subject": "...",
"content": [...],
"headers": {
"Feedback-ID": "Campaign123.User456.Prod"
}
}
• Register and verify your sending domain with Gmail Postmaster Tools.
• Once verified, you can monitor:
• Spam rates
• Feedback loop data
• Domain reputation
• Authentication status (SPF, DKIM, DMARC)
• Use the Feedback-ID values to correlate Gmail feedback with your campaigns or user segments.
Additional Information
• For Gmail’s official guidance on the Feedback-ID header, see: Gmail Documentation.
• For more on Gmail and Yahoo’s 2024 sender requirements, see: SendGrid Blog: New Sending Requirements for Gmail and Yahoo!
• For best practices on email deliverability, see: SendGrid Deliverability Guide
• For more on using Gmail Postmaster Tools: Gmail Postmaster Tools Help