Add suppressions to a suppression group
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.
Bearer <<YOUR_API_KEY_HERE>>
Optional
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.
The id of the unsubscribe group that you are adding suppressions to.
application/json
The array of email addresses to add or find.
Optional
The email addresses you added to the unsubscribe group
1const client = require("@sendgrid/client");2client.setApiKey(process.env.SENDGRID_API_KEY);34const group_id = "group_id";5const data = {6recipient_emails: ["test1@example.com", "test2@example.com"],7};89const request = {10url: `/v3/asm/groups/${group_id}/suppressions`,11method: "POST",12body: data,13};1415client16.request(request)17.then(([response, body]) => {18console.log(response.statusCode);19console.log(response.body);20})21.catch((error) => {22console.error(error);23});