diff --git a/source/API_Reference/SMTP_API/suppressions.md b/source/API_Reference/SMTP_API/suppressions.md index ed1a4fcc8b..716076b953 100644 --- a/source/API_Reference/SMTP_API/suppressions.md +++ b/source/API_Reference/SMTP_API/suppressions.md @@ -23,8 +23,30 @@ You may only specify one group per send, and you should wait one minute after cr } {% endcodeblock %} +{% anchor h2 %} +Defining ASM Groups to display on the Manage Preferences page +{% endanchor %} + +To specify which groups to display on the Manage Preferences page of an email, add the group IDs to the X-SMTPAPI header of an SMTP message, or in the x-smtpapi parameter of a [mail.send API +call]({{root_url}}/API_Reference/Web_API/mail.html). +If the asm_groups_to_display header is omitted, your default groups will be shown on the Manage Preferences page instead. + +{% warning %} +You can specify up to 25 groups to display. +{% endwarning %} + +{% codeblock lang:json %} +{ + "asm_groups_to_display": [1, 2, 3] +} +{% endcodeblock %} + +{% anchor h2 %} +Groups +{% endanchor %} + You can find your group IDs by looking at the Group ID column in the Advanced Suppression Manager UI, or by calling the [GET method]({{root_url}}/API_Reference/Web_API_v3/Advanced_Suppression_Manager/groups.html#-GET) of the groups resource. Related Articles: -* You can create ASM groups via the [API V3 > ASM Endpoint]({{root_url}}/API_Reference/Web_API_v3/Unsubscribe_Manager/groups.html#-POST). \ No newline at end of file +* You can create ASM groups via the [API V3 > ASM Endpoint]({{root_url}}/API_Reference/Web_API_v3/Unsubscribe_Manager/groups.html#-POST).