HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Suppress Profiles

Manually suppress profiles using their email address, or by specifying a segment or list ID to suppress all current members.

Suppressed profiles cannot receive email marketing, independent of their consent status. To learn more, see our email suppressions guide and our collecting consent guide.

Email addresses per request limit: 100

Rate limits:
Burst: 75/s
Steady: 700/m

Scopes:
profiles:write
subscriptions:write

Body Params

Suppresses one or more profiles from receiving marketing. Currently, supports email only. If a profile is not found with the given email, one will be created and immediately suppressed.

object
required
string
required
object
required
object

The profile(s) to create suppressions for.

array of objects
required
data*
string
required
object
required
object
object
object
required
string
required
string
required
Defaults to Y6nRLr

Suppress all profiles in this list

object
object
required
string
required
string
required
Defaults to Y6nRLr

Suppress all profiles in this segment

Headers
string
required
Defaults to 2024-02-15

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses
202

Success

Language
Credentials