Get SendGrid email delivery stats for an integration

GET 
/v1/integrations/:integration_id/sendgrid/stats

Returns aggregated SendGrid email delivery statistics for a date range. The response includes the resolved query window (start_date, end_date, aggregated_by), range-wide totals under totals, and a per-bucket breakdown. Counts are scoped to the integration: stats are fetched with the integration's own (subuser-scoped) SendGrid API key.

Permissions - integrations.read. API keys - manage.

Request

Responses

200

Aggregated email delivery stats

400

BadRequest

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789

401

Unauthorized

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789

403

The requested integration belongs to a different account, or the integration's SendGrid API key lacks the stats.read scope.

404

The specified resource was not found

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789

500

SendGrid API unreachable or returned an unexpected error.