Skip to contentSkip to navigationSkip to topbar
On this page

Update Account Offerings



API Overview

api-overview page anchor

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(link takes you to an external page).

The Account Provisioning API offering operations allow you to update and list Twilio SendGrid features or offerings available for your customer accounts.

The Update Account Offerings operation allows you to add or remove offerings from a specific customer account. Offerings are Twilio SendGrid features or offerings such as a dedicated IP address or Marketing Campaigns package.

The update is an idempotent PUT operation and each request overwrites existing offerings on the customer account. For this reason, you should include any permissions you want the account to retain with each request, omitting only those you wish to remove from the account. Upgrades and downgrades are available immediately after account provisioning.

To retrieve a list of all the offerings you may assign to a customer account, use the List Offerings operation.


PUT/v3/partners/accounts/{accountID}/offerings

Base url: https://api.sendgrid.com (for global users and subusers)

Base url: https://api.eu.sendgrid.com (for EU regional subusers)

Changes a package offering for the specified account. Please note that an account can have only one package offering. Also associates one or more add-on offerings such as Marketing Campaigns, Dedicated IP Addresses, and Expert Services to the specified account.


Authentication

authentication page anchor
Property nameTypeRequiredDescription
Authorizationstringrequired
Default: Bearer <<YOUR_API_KEY_HERE>>
Property nameTypeRequiredDescription
accountIDstringrequired

Twilio SendGrid account ID

Encoding type:application/json
SchemaExample
Property nameTypeRequiredDescriptionChild properties
offeringsarray[object]required

List of offerings to assign to account.

200400401403

OK

Schema
Property nameTypeRequiredDescriptionChild properties
offeringsarray[object]
Update customer account offeringsLink to code sample: Update customer account offerings
1
const client = require('@sendgrid/client');
2
client.setApiKey(process.env.SENDGRID_API_KEY);
3
4
const accountID = "ZGkrHSypTsudrGkmdpJJ";
5
const data = {
6
"offerings": [
7
{
8
"name": "Miss Christine Morgan",
9
"type": "package"
10
}
11
]
12
};
13
14
const request = {
15
url: `/v3/partners/accounts/${accountID}/offerings`,
16
method: 'PUT',
17
body: data
18
}
19
20
client.request(request)
21
.then(([response, body]) => {
22
console.log(response.statusCode);
23
console.log(response.body);
24
})
25
.catch(error => {
26
console.error(error);
27
});