Stopping an in-progress send
If you are looking for information on how to cancel a scheduled email or campaign, click here!
Stopping Transactional Email
Stopping an ongoing send that is using SMTP or the Web API can be tricky, because we strive to accept and send email requests as quickly as possible. Sometimes stopping an accidental send is just not possible. However, following are several suggestions for how to halt a send in progress or a send that you have scheduled.
1. Change Your API Key or Password
The simple act of changing your API key or password can break your existing email integration by causing a mismatch between what your app is trying to authenticate with and what we have on record.
This method is great if you have a runaway script or have just started a send accidentally. Be sure to verify that the credentials your app is using belong either to the parent account or a teammate so you can change the proper one.
Using an API key has the added benefit of breaking only the services for which it has permissions. In addition to enhanced security, the ease of change afforded by an API key is one reason we recommend using API keys to authenticate with our services.
We cannot guarantee that changing your API key or password will prevent 100% of your email requests from being delivered. We only recommend this method as a last resort that may allow you to stop at least some of your emails from being sent.
2. Contact Support
Support has the ability to clear any emails currently pending delivery from your account. To be more clear, there is a very small window of opportunity between when we accept an email request and when we actually attempt delivery to the recipient. Emails can build up in this queue, and upon request, we can delete them entirely.
Stopping a Marketing Campaign
You have several options for canceling or unscheduling a campaign.
Using the User Interface
If you have Send Immediately under the Scheduling dropdown menu in the campaign builder set to OFF, then you only have a very brief window of opportunity to cancel the campaign after clicking Send Campaign. You have 2 options:
- Deleting the Campaign
Navigate to your Campaigns page. Find the campaign you want to stop, click the action menu and select Delete.
- Canceling the Campaign
Navigate to your Campaigns page. Find the campaign you want to stop and click the little red X next to the campaign name to cancel the campaign. Click Confirm in the confirmation window that appears. You'll see the status of your campaign change to "Canceled".
Using the SendGrid API
New Marketing Campaigns
You can cancel a scheduled send by making a call to /marketing/singlesends/{id}/schedule where {id}
is the ID of the Single Send you want to stop. A successful deletion will return a 200.
Legacy Marketing Campaigns
You can delete a campaign by making a call to /v3/campaigns/{campaign_id} where {campaign_id}
is the ID of the campaign you want to stop. A successful deletion will return a 204.
DELETE https://api.sendgrid.com/v3/campaigns/{campaign_id}
HTTP/1.1 204
Need some help?
We all do sometimes. Get help now from the Twilio SendGrid Support Team.
Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.