SendGrid
Welcome to SendGrid’s Web API v3! This API is RESTful, fully featured, and easy to integrate with.
8.1k subscribers
0.1/10 popularity
183 ms avg latency
71 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
SendGrid endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST |
Send /mail/send |
This endpoint allows you to send email over SendGrid’s v3 Web API, |
| Blocks | ||
| GET |
Retrieve a specific block /suppression/blocks/{email}} |
This endpoint allows you to retrieve a specific email address from your blocks list. Blocks happen when your message was rejected for a reason related to the message, not the… |
| GET |
Retrieve all blocks /suppression/blocks |
This endpoint allows you to retrieve a list of all email addresses that are currently on your blocks list. There are several causes for emails: for example, your mail server IP… |
| DELETE |
Delete a specific block /suppression/blocks/{email}} |
This endpoint allows you to delete a specific email address from your blocks list. Blocks happen when your message was rejected for a reason related to the message, not the… |
| Bounces | ||
| DELETE |
Delete a bounce /suppression/bounces/{email} |
This endpoint allows you to remove an email address from your bounce list. A bounced email is when the message is undeliverable and then returned to the server that sent it. This… |
| GET |
Retrieve a bounce /suppression/bounces/{email} |
This endpoint allows you to retrieve a specific bounce for a given email address. A bounced email is when the message is undeliverable and then returned to the server that sent it. |
| GET |
Retrieve all bounces /suppression/bounces |
This endpoint allows you to retrieve all of your bounces. A bounced email is when the message is undeliverable and then returned to the server that sent it. |
| Invalid Emails | ||
| GET |
Retrieve all invalid emails /suppression/invalid_emails |
This endpoint allows you to retrieve a list of all invalid email addresses. An invalid email occurs when you attempt to send email to an address that is formatted in a manner… |
| GET |
Retrieve a specific invalid email /suppression/invalid_emails/{email} |
This endpoint allows you to retrieve a specific invalid email addresses. An invalid email occurs when you attempt to send email to an address that is formatted in a manner that… |
| DELETE |
Delete a specific invalid email /suppression/invalid_emails/{email} |
This endpoint allows you to remove a specific email address from the invalid email address list. An invalid email occurs when you attempt to send email to an address that is… |
| Spam Reports | ||
| GET |
Retrieve all spam reports /suppression/spam_reports |
This endpoint allows you to retrieve all spam reports. Spam reports happen when a recipient indicates that they think your email is spam and then their email provider reports… |
| DELETE |
Delete a specific spam report /suppression/spam_reports/{email} |
This endpoint allows you to delete a specific spam report. Spam reports happen when a recipient indicates that they think your email is spam and then their email provider reports… |
| GET |
Retrieve a specific spam report /suppression/spam_reports/{email} |
This endpoint allows you to retrieve a specific spam report. Spam reports happen when a recipient indicates that they think your email is spam and then their email provider… |
| Cancel Scheduled Sends | ||
| POST |
Create a batch ID /mail/batch |
This endpoint allows you to generate a new batch ID. This batch ID can be associated with scheduled sends via the mail/send endpoint. If you set the SMTPAPI header batch_id, it… |
| GET |
Validate Batch ID /mail/batch/{batch_id} |
|
| POST |
Cancel or pause a scheduled send /user/scheduled_sends |
This endpoint allows you to cancel or pause an email that has been scheduled to be sent. If the maximum number of cancellations/pauses are added, HTTP 400 will be returned. The… |
| GET |
Retrieve all scheduled sends /user/scheduled_sends |
This endpoint allows you to retrieve all cancel/paused scheduled send information. The Cancel Scheduled Sends feature allows the customer to cancel a scheduled send based on a… |
| GET |
Retrieve scheduled send /user/scheduled_sends/{batch_id} |
This endpoint allows you to retrieve the cancel/paused scheduled send information for a specific batch_id. The Cancel Scheduled Sends feature allows the customer to cancel a… |
| PATCH |
Update user scheduled send information /user/scheduled_sends/{batch_id} |
This endpoint allows you to update the status of a scheduled send for the given batch_id. The Cancel Scheduled Sends feature allows the customer to cancel a scheduled send based… |
| DELETE |
Delete a cancellation or pause of a scheduled send /user/scheduled_sends/{batch_id} |
This endpoint allows you to delete the cancellation/pause of a scheduled send. The Cancel Scheduled Sends feature allows the customer to cancel a scheduled send based on a Batch… |
| Unsubscribe Groups | ||
| GET |
Retrieve all suppression groups associated with the user. /asm/groups |
This endpoint allows you to retrieve a list of all suppression groups created by this user. Suppression groups, or unsubscribe groups, are specific types or categories of email… |
| PATCH |
Update a suppression group. /asm/groups/{group_id} |
This endpoint allows you to update or change a suppression group. Suppression groups, or unsubscribe groups, are specific types or categories of email that you would like your… |
| POST |
Create a new suppression group /asm/groups |
This endpoint allows you to create a new suppression group. Suppression groups, or unsubscribe groups, are specific types or categories of email that you would like your… |
| GET |
Get information on a single suppression group. /asm/groups/{group_id} |
This endpoint allows you to retrieve a single suppression group. Suppression groups, or unsubscribe groups, are specific types or categories of email that you would like your… |
| DELETE |
Delete a suppression group. /asm/groups/{group_id} |
This endpoint allows you to delete a suppression group. You can only delete groups that have not been attached to sent mail in the last 60 days. If a recipient uses the… |
| Suppressions (Unsubscribe) | ||
| POST |
Add suppressions to a suppression group /asm/groups/{group_id}/suppressions |
This endpoint allows you to add email addresses to an unsubscribe group. If you attempt to add suppressions to a group that has been deleted or does not exist, the suppressions… |
| GET |
Retrieve all suppressions for a suppression group /asm/groups/{group_id}/suppressions |
This endpoint allows you to retrieve all suppressed email addresses belonging to the given group. Suppressions are recipient email addresses that are added to unsubscribe groups.… |
| GET |
Retrieve all suppression groups for an email address /asm/suppressions/{email} |
This endpoint returns the list of all groups that the given email address has been unsubscribed from. Suppressions are a list of email addresses that will not receive content… |
| DELETE |
Delete a suppression from a suppression group /asm/groups/{group_id}/suppressions/{email} |
This endpoint allows you to remove a suppressed email address from the given suppression group. Suppressions are recipient email addresses that are added to unsubscribe groups.… |
| POST |
Search for suppressions within a group /asm/groups/{group_id}/suppressions/search |
This endpoint allows you to search a suppression group for multiple suppressions. When given a list of email addresses and a group ID, this endpoint will return only the email… |
| GET |
Retrieve all suppressions /asm/suppressions |
This endpoint allows you to retrieve a list of all suppressions. Suppressions are a list of email addresses that will not receive content sent under a given group. |
| Settings - Tracking | ||
| GET |
Retrieve Google Analytics Settings /tracking_settings/google_analytics |
This endpoint allows you to retrieve your current setting for Google Analytics. |
| PATCH |
Update Google Analytics Settings /tracking_settings/google_analytics |
This endpoint allows you to update your current setting for Google Analytics. |
| GET |
Retrieve Tracking Settings /tracking_settings |
This endpoint allows you to retrieve a list of all tracking settings that you can enable on your account. You can track a variety of the actions your recipients may take when… |
| GET |
Retrieve Click Track Settings /tracking_settings/click |
This endpoint allows you to retrieve your current click tracking setting. You can track a variety of the actions your recipients may take when interacting with your emails… |
| PATCH |
Update Click Tracking Settings /tracking_settings/click |
This endpoint allows you to change your current click tracking setting. You can enable, or disable, click tracking using this endpoint. You can track a variety of the actions… |
| GET |
Retrieve Subscription Tracking Settings /tracking_settings/subscription |
This endpoint allows you to retrieve your current settings for subscription tracking. Subscription tracking adds links to the bottom of your emails that allows your recipients to… |
| PATCH |
Update Open Tracking Settings /tracking_settings/open |
This endpoint allows you to update your current settings for open tracking. Open Tracking adds an invisible image at the end of the email which can track email opens. If the… |
| GET |
Get Open Tracking Settings /tracking_settings/open |
This endpoint allows you to retrieve your current settings for open tracking. Open Tracking adds an invisible image at the end of the email which can track email opens. If the… |
| PATCH |
Update Subscription Tracking Settings /tracking_settings/subscription |
This endpoint allows you to update your current settings for subscription tracking. Subscription tracking adds links to the bottom of your emails that allows your recipients to… |
| Settings - Mail | ||
| GET |
Retrieve all mail settings /mail_settings |
This endpoint allows you to retrieve a list of all mail settings. Mail settings allow you to tell SendGrid specific things to do to every email that you send to your recipients… |
| GET |
Retrieve all BCC mail settings /mail_settings/bcc |
This endpoint allows you to retrieve your current BCC mail settings. When the BCC mail setting is enabled, SendGrid will automatically send a blind carbon copy (BCC) to an… |
| PATCH |
Update address whitelist mail settings /mail_settings/address_whitelist |
This endpoint allows you to update your current email address whitelist settings. The address whitelist setting whitelists a specified email address or domain for which mail… |
| PATCH |
Update BCC mail settings /mail_settings/bcc |
This endpoint allows you to update your current BCC mail settings. When the BCC mail setting is enabled, SendGrid will automatically send a blind carbon copy (BCC) to an address… |
| GET |
Retrieve address whitelist mail settings /mail_settings/address_whitelist |
This endpoint allows you to retrieve your current email address whitelist settings. The address whitelist setting whitelists a specified email address or domain for which mail… |
| GET |
Retrieve footer mail settings /mail_settings/footer |
This endpoint allows you to retrieve your current Footer mail settings. The footer setting will insert a custom footer at the bottom of the text and HTML bodies. Use the embedded… |
| PATCH |
Update footer mail settings /mail_settings/footer |
This endpoint allows you to update your current Footer mail settings. The footer setting will insert a custom footer at the bottom of the text and HTML bodies. Use the embedded… |
| GET |
Retrieve forward spam mail settings /mail_settings/forward_spam |
This endpoint allows you to retrieve your current Forward Spam mail settings. Enabling the forward spam setting allows you to specify an email address to which spam reports will… |
| PATCH |
Update forward spam mail settings /mail_settings/forward_spam |
This endpoint allows you to update your current Forward Spam mail settings. Enabling the forward spam setting allows you to specify an email address to which spam reports will be… |
| GET |
Retrieve plain content mail settings /mail_settings/plain_content |
This endpoint allows you to retrieve your current Plain Content mail settings. The plain content setting will automatically convert any plain text emails that you send to HTML… |
+ 21 more endpoints on the provider's documentation.
SendGrid pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 10 / second |
|
| PRO | $9.95 / month | 10 / second |
|
| ULTRA | $79.95 / month | 10 / second |
|
| MEGA | $199.95 / month | 50 / second |
|
