Stopping an in-progress send

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 not possible. However, following are several suggestions for how to halt a send in progress or a send that you have scheduled.

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 SendGrid has 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 the key 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.

SendGrid Support has the ability to clear any emails currently pending delivery from your account. 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, Support can delete them entirely.

You have several options for canceling or unscheduling a campaign.

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:

1. Deleting the Campaign

   Navigate to your Campaigns page. Find the campaign you want to stop, click the action menu and select Delete.

2. 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".

   Expand image

   ---

   Expand image

   ---

   Expand image

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.

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