# 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

| Setting             | Type    | Required | Description                                                                                                                                                   |
| ------------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Use synthetic data  | boolean | No       | Generate synthetic demo data instead of connecting to the real data source.                                                                                   |
| Backfill start time | string | No | The date to start fetching data from. If not specified, no past records will be fetched. |
| API Rate Limit | object | No | Optional limit on the connector's outbound request rate to the source API. Leave blank to use the connector's default behavior. See [API Rate Limiting](../../../guides/rate-limiting) for the field format, limits, and how to choose a value. |

#### Secrets

| Secret  | Type   | Required | Description                                                                                                           |
| ------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------- |
| API Key | string | Yes      | SendGrid API Key with Email Activity read permissions. This is required to authenticate requests to the SendGrid API. |

## Related Articles

- [SendGrid Email Activity API Documentation](https://docs.sendgrid.com/api-reference/email-activity/filter-all-messages)
- [SendGrid API Key Authentication](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/authentication)
- [SendGrid Email Activity Overview](https://docs.sendgrid.com/ui/analytics-and-reporting/email-activity-feed)

## Sample Record

```json
{
  "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
}
```