Twilio SendGrid Email Activity API
The Twilio SendGrid Email Activity API allows you to query all of your stored messages, query individual messages, and download a CSV with data about the…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
The Twilio SendGrid Email Activity API allows you to query all of your stored messages, query individual messages, and download a CSV with data about the stored messages. Once retrieved, you can inspect the data associated with your messages to better understand your mail send. For example, you may retrieve all bounced messages or all messages with the same subject line and search for commonalities among them.
You must purchase additional email activity history to gain access to the Email Activity Feed API.
See Getting Started with the Email Activity Feed API for help building queries and working with this API. You can also work with email activity in the Activity section of the Twilio SendGrid application user interface.
Endpoints 4
Email Activity
- GETFilter all messages
/v3/messages?query=string&limit=10Filter all messages to search your Email Activity. All queries must be URL encoded, and use the following format: query={query_type}="{query_content}" Once… - GETFilter messages by message ID
/v3/messages/:msg_idGet all of the details about the specified message. For Regional (EU) subusers, no data will be generated for this service. - POSTRequest CSV
/v3/messages/download?query=stringThis request will kick off a backend process to generate a CSV file. Once generated, the worker will then send an email for the user download the file. The… - GETDownload CSV
/v3/messages/download/:download_uuidThis endpoint will return a presigned URL that can be used to download the CSV that was requested from the "Request a CSV" endpoint.
API details
- Base URL
https://api.sendgrid.com- Authentication
- A bearer token in the Authorization header
- Operations
- 4 operations on 4 pathsGET 3POST 1
- Main resources
- Email Activity 4
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
1.0.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
How to test the Twilio SendGrid Email Activity API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Twilio SendGrid Email Activity API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Filter all messages” (GET /v3/messages?query=string&limit=10), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Twilio SendGrid Email Activity API?
The Twilio SendGrid Email Activity API allows you to query all of your stored messages, query individual messages, and download a CSV with data about the… It is listed under Communication and has 4 endpoints.
Who publishes the Twilio SendGrid Email Activity API?
It is listed from SendGrid's public API description (an OpenAPI document), not published by SendGrid on Swastik Codes. Anyone who controls sendgrid.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Twilio SendGrid Email Activity API?
Requests go to https://api.sendgrid.com. Endpoint paths are added to this base URL.
How do I authenticate with the Twilio SendGrid Email Activity API?
With A bearer token in the Authorization header.
How many endpoints does the Twilio SendGrid Email Activity API have?
4 operations on 4 paths (3 GET, 1 POST). The largest groups are Email Activity.
Is forking the Twilio SendGrid Email Activity API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.