Remove flagged addresses from the audience

Remove flagged addresses from the audience

POST/api/v1/email/campaigns/{id}/quality/remove-affected

POST /email/campaigns/{id}/quality/remove-affected
curl -X POST 'https://www.unitpost.com/api/v1/email/campaigns/cmp_123/quality/remove-affected' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'User-Agent: my-app/1.0'
Response · 200
{
  "object": "campaign_quality_removal",
  "removed": 0
}

While a campaign is paused for its delivery quality: take every hard-bounced and complained contact out of its static segment. It edits a reusable segment for good. Each removal records its activity and fires segment.left (the first at once, the rest within a few minutes); a repeat removes nothing. A campaign that isn't paused for quality, or a filter (dynamic) segment, is a 409 (a filter's matches can't be removed one by one, and they're suppressed anyway). It doesn't resume the campaign. No body. Requires the segments:write capability.

Parameters1 field
FieldTypeDescription
idrequiredstring · path—
Response · 200 fields2 fields
FieldTypeDescription
objectrequiredenumcampaign_quality_removal—
removedrequiredinteger—
200400401403404409422503

Search docs and guides

Search the docs and product guides.