{"@context": "https://schema.org", "@type": "WebAPI", "name": "Email Activity (beta) API", "description": "The Beta endpoints for the new Email Activity APIs - functionality is subject to change without notice. You may not have access to this Beta endpoint. Email Activity offers filtering and search by event type for two days worth of data. There is an optional add-on to store 60 days worth of data. Thi", "provider": {"@type": "Organization", "name": "sendgrid.com"}, "documentation": "https://raw.githubusercontent.com/sendgrid/sendgrid-oai/main/oai.json"}
Index / APIs / sendgrid.com

Email Activity (beta) API

The Beta endpoints for the new Email Activity APIs - functionality is subject to change without notice. You may not have access to this Beta endpoint. Email Activity offers filtering and search by event type for two days worth of data. There is an optional add-on to store 60 days worth of data. Thi

Every row below was read from the vendor's own OpenAPI document. The summary text is theirs. What this registry adds is that each operation is indexed with its method, path, base URL and auth scheme, so a search for a capability can answer with a call rather than a name, and that the endpoint is probed on a schedule.

Specifications as held by the APIs.guru corpus, whose newest record is 2023-04-21. Operations the vendor has added since are not listed here; the origin links above are the vendor's own current documents.

base URLs: http://api.sendgrid.com/v3

auth: a p i k e y

find it by capability: POST /search {"query":{"text":"..."}} returns these operations with their invocation detail. Connect any agent client.

Email Activity (beta) v1.0.0

The Beta endpoints for the new Email Activity APIs - functionality is subject to change without notice. You may not have access to this Beta endpoint. Email Activity offers filtering and search by event type for two days worth of data. There is an optional add-on to store 60 days worth of data. This add-on also gives you access to the ability to download a CSV of the 60 days worth of email event

methodpathwhat the vendor says it does
GET/access_settings/activityRetrieve all recent access attempts **This endpoint allows you to retrieve a list of all of the IP addresses t
GET/access_settings/whitelistRetrieve a list of currently allowed IPs **This endpoint allows you to retrieve a list of IP addresses that ar
POST/access_settings/whitelistAdd one or more IPs to the allow list **This endpoint allows you to add one or more allowed IP addresses.** T
DELETE/access_settings/whitelistRemove one or more IPs from the allow list **This endpoint allows you to remove one or more IP addresses from
GET/access_settings/whitelist/{rule_id}Retrieve a specific allowed IP **This endpoint allows you to retreive a specific IP address that has been allo
DELETE/access_settings/whitelist/{rule_id}Remove a specific IP from the allowed list **This endpoint allows you to remove a specific IP address from you
GET/alertsRetrieve all alerts **This endpoint allows you to retrieve all of your alerts.** Alerts allow you to specify
POST/alertsCreate a new Alert **This endpoint allows you to create a new alert.** Alerts allow you to specify an email a
GET/alerts/{alert_id}Retrieve a specific alert **This endpoint allows you to retrieve a specific alert.** Alerts allow you to spec
PATCH/alerts/{alert_id}Update an alert **This endpoint allows you to update an alert.** Alerts allow you to specify an email address
DELETE/alerts/{alert_id}Delete an alert **This endpoint allows you to delete an alert.** Alerts allow you to specify an email address
GET/api_keysRetrieve all API Keys belonging to the authenticated user **This endpoint allows you to retrieve all API Keys
POST/api_keysCreate API keys **This endpoint allows you to create a new API Key for the user.** To create your initial Sen
GET/api_keys/{api_key_id}Retrieve an existing API Key **This endpoint allows you to retrieve a single API key using an `api_key_id`.**
PUT/api_keys/{api_key_id}Update API key name and scopes **This endpoint allows you to update the name and scopes of a given API key.**
PATCH/api_keys/{api_key_id}Update API key name **This endpoint allows you to update the name of an existing API Key.** You must pass thi
DELETE/api_keys/{api_key_id}Delete API keys **This endpoint allows you to revoke an existing API Key using an `api_key_id`** Authenticati
GET/asm/groupsRetrieve all suppression groups associated with the user. **This endpoint allows you to retrieve a list of all
POST/asm/groupsCreate a new suppression group **This endpoint allows you to create a new suppression group.** To add an emai
GET/asm/groups/{group_id}Get information on a single suppression group. **This endpoint allows you to retrieve a single suppression gro
PATCH/asm/groups/{group_id}Update a suppression group. **This endpoint allows you to update or change a suppression group.** Suppressions
DELETE/asm/groups/{group_id}Delete a Suppression Group **This endpoint allows you to delete a suppression group.** If a recipient uses th
GET/asm/groups/{group_id}/suppressionsRetrieve all suppressions for a suppression group **This endpoint allows you to retrieve all suppressed email
POST/asm/groups/{group_id}/suppressionsAdd suppressions to a suppression group **This endpoint allows you to add email addresses to an unsubscribe gr
POST/asm/groups/{group_id}/suppressions/searchSearch for suppressions within a group **This endpoint allows you to search a suppression group for multiple s
DELETE/asm/groups/{group_id}/suppressions/{email}Delete a suppression from a suppression group **This endpoint allows you to remove a suppressed email address
GET/asm/suppressionsRetrieve all suppressions **This endpoint allows you to retrieve a list of all suppressions.** Suppressions -
POST/asm/suppressions/globalAdd recipient addresses to the global suppression group. **This endpoint allows you to add one or more email a
GET/asm/suppressions/global/{email}Retrieve a Global Suppression **This endpoint allows you to retrieve a global suppression. You can also use th
DELETE/asm/suppressions/global/{email}Delete a Global Suppression **This endpoint allows you to remove an email address from the global suppressions
GET/asm/suppressions/{email}Retrieve all suppression groups for an email address **This endpoint returns a list of all groups from which t
GET/browsers/statsRetrieve email statistics by browser. **This endpoint allows you to retrieve your email statistics segmented b
GET/campaignsRetrieve all Campaigns **This endpoint allows you to retrieve a list of all of your campaigns.** Returns camp
POST/campaignsCreate a Campaign **This endpoint allows you to create a campaign.** In order to send or schedule the campaig
GET/campaigns/{campaign_id}Retrieve a single campaign **This endpoint allows you to retrieve a specific campaign.** Campaigns API
PATCH/campaigns/{campaign_id}Update a Campaign **This endpoint allows you to update a specific campaign.** This is especially useful if yo
DELETE/campaigns/{campaign_id}Delete a Campaign **This endpoint allows you to delete a specific campaign.** Campaigns API
GET/campaigns/{campaign_id}/schedulesView Scheduled Time of a Campaign **This endpoint allows you to retrieve the date and time that a campaign has
POST/campaigns/{campaign_id}/schedulesSchedule a Campaign **This endpoint allows you to schedule a specific date and time for your campaign to be se
PATCH/campaigns/{campaign_id}/schedulesUpdate a Scheduled Campaign **This endpoint allows to you change the scheduled time and date for a campaign to

and 160 more operation(s) in this specification, all searchable.

specification origin: https://raw.githubusercontent.com/sendgrid/sendgrid-oai/main/oai.json

nothing on this page is a rating, an endorsement or a claim about quality. Reachability is what our probes observed from one network; answering is a floor under usefulness, not a measure of it.