Skip to main content

​
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

​
Jobs

​
Rate Limits & Production Notes

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