Suppression Groups
Update Suppression Group
Update a suppression group’s name or description using the AutoSend API.
PUT
/
suppression-groups
/
{groupId}
curl --request PUT \
--url 'https://api.autosend.com/v1/suppression-groups/AB12C3' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Marketing Unsubscribes — Updated",
"description": "Users who opted out of all marketing emails",
"isActive": true
}'
import requests
response = requests.put(
"https://api.autosend.com/v1/suppression-groups/AB12C3",
headers={
"Authorization": "Bearer <token>",
"Content-Type": "application/json",
},
json={
"name": "Marketing Unsubscribes — Updated",
"description": "Users who opted out of all marketing emails",
"isActive": true,
},
)
print(response.json())
const response = await fetch(
"https://api.autosend.com/v1/suppression-groups/AB12C3",
{
method: "PUT",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "Marketing Unsubscribes — Updated",
description: "Users who opted out of all marketing emails",
isActive: true,
}),
}
);
const data = await response.json();
console.log(data);
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.autosend.com/v1/suppression-groups/AB12C3");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
"name" => "Marketing Unsubscribes — Updated",
"description" => "Users who opted out of all marketing emails",
"isActive" => true,
]));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer <token>",
"Content-Type: application/json",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
)
func main() {
payload, _ := json.Marshal(map[string]interface{}{
"name": "Marketing Unsubscribes — Updated",
"description": "Users who opted out of all marketing emails",
"isActive": true,
})
req, _ := http.NewRequest("PUT", "https://api.autosend.com/v1/suppression-groups/AB12C3", bytes.NewBuffer(payload))
req.Header.Set("Authorization", "Bearer <token>")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.*;
public class Main {
public static void main(String[] args) throws Exception {
String body = """
{
"name": "Marketing Unsubscribes — Updated",
"description": "Users who opted out of all marketing emails",
"isActive": true
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.autosend.com/v1/suppression-groups/AB12C3"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.PUT(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
require "net/http"
require "uri"
require "json"
uri = URI("https://api.autosend.com/v1/suppression-groups/AB12C3")
req = Net::HTTP::Put.new(uri)
req["Authorization"] = "Bearer <token>"
req["Content-Type"] = "application/json"
req.body = {
name: "Marketing Unsubscribes — Updated",
description: "Users who opted out of all marketing emails",
isActive: true,
}.to_json
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts response.body
{
"success": true,
"data": {
"id": "6a0c49ef6ae88a19f5a01cb1",
"groupId": "GEHYB",
"name": "Marketing Unsubscribes - Updated",
"description": "Users who opted out of all marketing emails",
"isGlobal": false,
"isActive": true,
"suppressionCount": 0,
"createdAt": "2026-05-19T11:30:55.935Z",
"updatedAt": "2026-05-19T11:30:55.935Z"
}
}
curl --request PUT \
--url 'https://api.autosend.com/v1/suppression-groups/AB12C3' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Marketing Unsubscribes — Updated",
"description": "Users who opted out of all marketing emails",
"isActive": true
}'
import requests
response = requests.put(
"https://api.autosend.com/v1/suppression-groups/AB12C3",
headers={
"Authorization": "Bearer <token>",
"Content-Type": "application/json",
},
json={
"name": "Marketing Unsubscribes — Updated",
"description": "Users who opted out of all marketing emails",
"isActive": true,
},
)
print(response.json())
const response = await fetch(
"https://api.autosend.com/v1/suppression-groups/AB12C3",
{
method: "PUT",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "Marketing Unsubscribes — Updated",
description: "Users who opted out of all marketing emails",
isActive: true,
}),
}
);
const data = await response.json();
console.log(data);
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.autosend.com/v1/suppression-groups/AB12C3");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
"name" => "Marketing Unsubscribes — Updated",
"description" => "Users who opted out of all marketing emails",
"isActive" => true,
]));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer <token>",
"Content-Type: application/json",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
)
func main() {
payload, _ := json.Marshal(map[string]interface{}{
"name": "Marketing Unsubscribes — Updated",
"description": "Users who opted out of all marketing emails",
"isActive": true,
})
req, _ := http.NewRequest("PUT", "https://api.autosend.com/v1/suppression-groups/AB12C3", bytes.NewBuffer(payload))
req.Header.Set("Authorization", "Bearer <token>")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.*;
public class Main {
public static void main(String[] args) throws Exception {
String body = """
{
"name": "Marketing Unsubscribes — Updated",
"description": "Users who opted out of all marketing emails",
"isActive": true
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.autosend.com/v1/suppression-groups/AB12C3"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.PUT(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
require "net/http"
require "uri"
require "json"
uri = URI("https://api.autosend.com/v1/suppression-groups/AB12C3")
req = Net::HTTP::Put.new(uri)
req["Authorization"] = "Bearer <token>"
req["Content-Type"] = "application/json"
req.body = {
name: "Marketing Unsubscribes — Updated",
description: "Users who opted out of all marketing emails",
isActive: true,
}.to_json
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts response.body
{
"success": true,
"data": {
"id": "6a0c49ef6ae88a19f5a01cb1",
"groupId": "GEHYB",
"name": "Marketing Unsubscribes - Updated",
"description": "Users who opted out of all marketing emails",
"isGlobal": false,
"isActive": true,
"suppressionCount": 0,
"createdAt": "2026-05-19T11:30:55.935Z",
"updatedAt": "2026-05-19T11:30:55.935Z"
}
}
Authorizations
string | header
required
Bearer authentication header of the form Bearer
<token>, where <token> is your auth token.Path Parameters
string
required
The unique identifier of the suppression group to update.
Body
string
Updated display name for the suppression group. Must be between 1 and 200 characters.
string
Updated description for the suppression group.
boolean
Whether the suppression group is active. Defaults to
true if not specified.Response
Suppression group updated successfullyboolean
Example:
trueobject
The updated suppression group.
Show child attributes
Show child attributes
string
Unique identifier for the suppression group.
string
Short code identifier used when referencing the group in campaigns and templates.
string
Display name of the suppression group.
string
Optional description of the suppression group.
boolean
Whether this is a global suppression group.
boolean
Whether the suppression group is active.
integer
Number of email addresses currently suppressed in this group.
string
ISO 8601 creation timestamp.
string
ISO 8601 last-updated timestamp.
Was this page helpful?
⌘I
curl --request PUT \
--url 'https://api.autosend.com/v1/suppression-groups/AB12C3' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Marketing Unsubscribes — Updated",
"description": "Users who opted out of all marketing emails",
"isActive": true
}'
import requests
response = requests.put(
"https://api.autosend.com/v1/suppression-groups/AB12C3",
headers={
"Authorization": "Bearer <token>",
"Content-Type": "application/json",
},
json={
"name": "Marketing Unsubscribes — Updated",
"description": "Users who opted out of all marketing emails",
"isActive": true,
},
)
print(response.json())
const response = await fetch(
"https://api.autosend.com/v1/suppression-groups/AB12C3",
{
method: "PUT",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "Marketing Unsubscribes — Updated",
description: "Users who opted out of all marketing emails",
isActive: true,
}),
}
);
const data = await response.json();
console.log(data);
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.autosend.com/v1/suppression-groups/AB12C3");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
"name" => "Marketing Unsubscribes — Updated",
"description" => "Users who opted out of all marketing emails",
"isActive" => true,
]));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer <token>",
"Content-Type: application/json",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
)
func main() {
payload, _ := json.Marshal(map[string]interface{}{
"name": "Marketing Unsubscribes — Updated",
"description": "Users who opted out of all marketing emails",
"isActive": true,
})
req, _ := http.NewRequest("PUT", "https://api.autosend.com/v1/suppression-groups/AB12C3", bytes.NewBuffer(payload))
req.Header.Set("Authorization", "Bearer <token>")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.*;
public class Main {
public static void main(String[] args) throws Exception {
String body = """
{
"name": "Marketing Unsubscribes — Updated",
"description": "Users who opted out of all marketing emails",
"isActive": true
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.autosend.com/v1/suppression-groups/AB12C3"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.PUT(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
require "net/http"
require "uri"
require "json"
uri = URI("https://api.autosend.com/v1/suppression-groups/AB12C3")
req = Net::HTTP::Put.new(uri)
req["Authorization"] = "Bearer <token>"
req["Content-Type"] = "application/json"
req.body = {
name: "Marketing Unsubscribes — Updated",
description: "Users who opted out of all marketing emails",
isActive: true,
}.to_json
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts response.body
{
"success": true,
"data": {
"id": "6a0c49ef6ae88a19f5a01cb1",
"groupId": "GEHYB",
"name": "Marketing Unsubscribes - Updated",
"description": "Users who opted out of all marketing emails",
"isGlobal": false,
"isActive": true,
"suppressionCount": 0,
"createdAt": "2026-05-19T11:30:55.935Z",
"updatedAt": "2026-05-19T11:30:55.935Z"
}
}