Skip to main content

Sendgrid Email Activity

Collects email activity and engagement data from your Twilio SendGrid account for tracking email delivery, opens, clicks, and other engagement metrics.

Sync Type: Incremental

Requirements

Before you connect Monad to Twilio SendGrid, you need an API Key:

  1. Login to your Sendgrid account.
  2. Create an API Key in your SendGrid dashboard:
    • Navigate to Settings > API Keys
    • Click Create API Key
    • Choose Restricted Access and grant the following permissions:
      • Email Activity - Read access
    • Copy the generated API key (this will only be shown once)

Configuration

The following configuration defines the input parameters. Each field's specifications, such as type, requirements, and descriptions, are detailed below.

Settings

SettingTypeRequiredDescription
Use synthetic databooleanNoGenerate synthetic demo data instead of connecting to the real data source.
Backfill start timestringNoThe date to start fetching data from. If not specified, no past records will be fetched.

Secrets

SecretTypeRequiredDescription
API KeystringYesSendGrid API Key with Email Activity read permissions. This is required to authenticate requests to the SendGrid API.

Sample Record

{
"from_email": "support@company.com",
"msg_id": "550e8400-e29b-41d4-a716-446655440000",
"subject": "account notification",
"to_email": "user@example.com",
"status": "delivered",
"opens_count": 2,
"clicks_count": 1,
"last_event_time": "2024-11-10T15:30:45Z",
"last_timestamp": 1731248445
}