remove_mailing_list_recipients, which keeps the contact so they can be restored, this deletes them for good: email, name, external_id and attributes, in any status. It can’t be undone, so the agent confirms the exact people with you before calling.
If the person had unsubscribed, Shipstar keeps only a one-way hash of their address on that list, so a later upsert_mailing_list_recipients still skips them — erasing someone never re-subscribes them. Use remove, not erase, for ordinary churn.
Arguments
At least one of
emails / external_ids; up to 1000 identifiers in total.
Returns
suppressed counts the erased recipients who had unsubscribed. A repeat call reports everything as not_found.
Example prompts
“Sam Lee asked us to delete their data — erase sam@example.com from every mailing list.”
“Erase user usr_42 from the Customers list; they closed their account and requested deletion.”The same operation is in the REST API as
POST /email/lists/{id}/recipients/erase and in the dashboard as Erase permanently.