Segments on the API

Saved, reusable audiences you can apply to an email instead of rebuilding filters

August 8, 2026

We've added segments to the API: saved, reusable audiences — a named set of tag and metadata filters that you can apply as the audience of an email instead of rebuilding the same rules every send.

Five new endpoints:

Note that an email's audience is a snapshot: applying a segment copies its filters onto the email, so editing or deleting a segment never changes emails you've already sent or scheduled. Emails continue to accept filters directly; segments are purely additive, and no existing endpoints change behavior.

Buttondown is the last email platform you’ll switch to.