Skip to contentSkip to navigationSkip to topbar
On this page

Add suppressions to a suppression group



API Overview

api-overview page anchor

Suppressions are recipient email addresses that are added to unsubscribe groups. Once a recipient's address is on the suppressions list for an unsubscribe group, they will not receive any emails that are tagged with that unsubscribe group.


POST/v3/asm/groups/{group_id}/suppressions

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

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

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 will be added to the global suppressions list.


Authentication

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

on-behalf-ofstringOptional

The on-behalf-of header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be "account-id" followed by the customer account's ID (e.g., on-behalf-of: account-id <account-id>). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., on-behalf-of: <subuser-username>). See On Behalf Of for more information.

Property nameTypeRequiredDescription
group_idstringrequired

The id of the unsubscribe group that you are adding suppressions to.

Encoding type:application/json
SchemaExample
Property nameTypeRequiredDescriptionChild properties
recipient_emailsarray[string<email>]required

The array of email addresses to add or find.

201
SchemaExample
Property nameTypeRequiredDescriptionChild properties
recipient_emailsarray[string<email>]

The email addresses you added to the unsubscribe group

Add suppressions to a suppression groupLink to code sample: Add suppressions to a suppression group
1
const client = require("@sendgrid/client");
2
client.setApiKey(process.env.SENDGRID_API_KEY);
3
4
const group_id = "ZGkrHSypTsudrGkmdpJJ";
5
const data = {
6
recipient_emails: ["test1@example.com", "test2@example.com"],
7
};
8
9
const request = {
10
url: `/v3/asm/groups/${group_id}/suppressions`,
11
method: "POST",
12
body: data,
13
};
14
15
client
16
.request(request)
17
.then(([response, body]) => {
18
console.log(response.statusCode);
19
console.log(response.body);
20
})
21
.catch((error) => {
22
console.error(error);
23
});

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.