Clean Audience List

PUT 
/audiences/clean-list/:id

Clean Audience List

Update the audience list based on email address quality scores (ranging from 1 to 10):

• 6-10: Mark as Subscribed (high-quality emails)
• 1-5: Mark as Inactive (low-quality emails)

Request

Path Parameters

id uuidrequired

ID of the Audience to cleanup

Responses

200

Successful operation

application/json

Schema

Schema

statusCode string
message string

Example (from schema)

{
  "statusCode": "200",
  "message": "List cleaning has started successfully. You'll receive an email notification once the cleaning process is completed."
}

400

Bad Request

application/json

Schema

Schema

message string

Example (from schema)

{
  "message": "Some error message"
}

401

API key is missing or invalid

402

Payment Required

application/json

Schema

Schema

message string

Example (from schema)

{
  "message": "Insufficient credits. Current balance: X, required: Y, deficit: Z"
}

404

Audience not found

application/json

Schema

Schema

statusCode string
message string

Example (from schema)

{
  "statusCode": "404",
  "message": "Audience not found with ID: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
}

405

Method Not Allowed

Loading...