Skip to content Skip to navigation Skip to topbar

Delete Account

API Overview

The Twilio SendGrid Account Provisioning API provides a platform for Twilio SendGrid resellers to manage their customers. This API is for companies that have a formal reseller partnership with Twilio SendGrid.

You can access Twilio SendGrid sub-account functionality without becoming a reseller. If you require sub-account functionality, see the Twilio SendGrid Subusers feature, which is available with Pro and Premier plans.

The Account Provisioning API account operations allow you to create, retrieve, and authenticate customer accounts.

Operation overview

DELETE/v3/partners/accounts/{accountID}

Base url: https://api.sendgrid.com

Delete a specific account under your organization by account ID. Note that this is an irreversible action that does the following:

Revokes API Keys and SSO so that the account user cannot log in or access SendGrid data.
Removes all offerings and configured SendGrid resources such as dedicated IPs.
Cancels billing effective immediately.

Operation details

Authentication

API Key

Headers

Property nameTypeRequiredDescription

Authorizationstringrequired

Default: Bearer <<YOUR_API_KEY_HERE>>

Path parameters

Property nameTypeRequiredDescription

accountIDstringrequired

Twilio SendGrid account ID

Responses

204400401403404

Account successfully deleted.

The request was formatted incorrectly or missing required parameters.

SchemaExample

Property nameTypeRequiredDescriptionChild properties

errorsarray[object]

Show child properties for errors

Request lacks valid authentication credentials

SchemaExample

Property nameTypeRequiredDescriptionChild properties

errorsarray[object]

Show child properties for errors

Not authorized to make the request

SchemaExample

Property nameTypeRequiredDescriptionChild properties

errorsarray[object]

Show child properties for errors

Not Found

SchemaExample

Property nameTypeRequiredDescriptionChild properties

errorsarray[object]

Show child properties for errors

Delete account

Node.js

Python

Java

PHP

Ruby

curl


_19const client = require('@sendgrid/client');
_19client.setApiKey(process.env.SENDGRID_API_KEY);
_19
_19const accountID = "ZGkrHSypTsudrGkmdpJJ";
_19
_19const request = {
_19  url: `/v3/partners/accounts/${accountID}`,
_19  method: 'DELETE',
_19  
_19}
_19
_19client.request(request)
_19  .then(([response, body]) => {
_19    console.log(response.statusCode);
_19    console.log(response.body);
_19  })
_19  .catch(error => {
_19    console.error(error);
_19  });