SendGrid

Integrate Mavera with SendGrid — device/geography persona refinement, A/B focus group extension, and bulk contact-to-persona pipelines

Overview

Pull data from SendGrid (Single Send Stats, A/B Tests, Marketing Contacts) → analyze with Mavera (Custom Personas, Focus Groups, Mave Agent) → refine personas by real engagement behavior, extend A/B tests with synthetic feedback, and create personas at scale from your contact database.

SendGrid API — Base URL: https://api.sendgrid.com/v3/. Auth: API Key as Authorization: Bearer SG.xxxxx. Rate limits: 600 req/min (10/sec sustained). Marketing endpoints share the same pool.

---

Prerequisites

1. SendGrid API key

   Create an API key at Settings → API Keys with scopes: marketing.read, stats.read, marketing.contacts.read.
2. Mavera API key

   Get your key from Mavera dashboard.
3. Environment variables

   export SENDGRID_API_KEY="SG.xxxxx"
   export MAVERA_API_KEY="mvra_live_xxxxx"
   

---

Jobs

#	Job	SendGrid Data	Mavera Surface	Output
1	Email Stats by Device/Geography → Persona Refinement	Single send stats with breakdowns	Custom Personas (update)	Device/geo-refined personas
2	Single Send A/B → Focus Group Extension	A/B test results	Focus Groups	Qualitative A/B feedback
3	Contact Export → Bulk Persona Creation	Marketing contacts export	Custom Personas	Segment personas at scale

---

---

Rate Limits & Production Notes

Endpoint	Limit	Strategy
All endpoints (shared)	600 req/min	100ms delay between calls
Contact exports	1 concurrent	Wait for completion before starting another
Single send stats	600 req/min (shared)	Batch with delays
Marketing contacts	600 req/min (shared)	Use exports for bulk reads

All SendGrid endpoints share the 600 req/min pool. A bulk stats pull plus persona creation can burn through this quickly. Space requests at 100ms+ and monitor X-RateLimit-Remaining headers.

Production checklist:

• Store SENDGRID_API_KEY and MAVERA_API_KEY in a secrets manager.
• Use segment-specific exports rather than full contact list exports to reduce data volume and processing time.
• For A/B extension jobs, create your personas once and reuse IDs across multiple test analyses via PERSONA_IDS env var.
• Contact exports generate temporary download URLs that expire. Download immediately after the export completes.
• Monitor Mavera credits at Dashboard.

---

All Integrations

SendGrid API

Personas

Focus Groups

Mave Agent

Generate