Audience

Audience is three lists: contacts, segments and topics. Open them in the console under Audience, or call the contacts, segments and topics routes.

Contacts

A contact is an address you already have a reason to write to. Search by the address. Filter by active, unsubscribed or bounced. A row shows the properties you stored, which topics that address receives, and why the status is what it is. From the same row you can open Emails filtered to that address.

A contact holds up to 100 properties. A property name is at most 128 characters and a value at most 16 KB. A write past any of these is refused whole, with the property named, and nothing in it is stored; set a property to null to remove it and free a place.

Adding a contact and editing properties are ordinary edits. Unsubscribing is not. A person may leave. When the reason is that they reported a message as spam, nothing in the console puts them back on the list.

Segments

A segment is a set of rules, and every rule has to match. Membership is whoever matches at the moment you look, plus anyone you add to it. The detail page writes each rule as a sentence and pages through the addresses that match.

An audience is a segment. Adding a contact with the audience id puts them in that segment, and listing that audience returns those people. Removing a contact from the audience takes them out of it and leaves them on the account.

The same rule editor is what create and edit use. A segment with no rules matches every contact.

Topics

A topic is one kind of mail. A contact can leave one kind and keep the others. Until they choose, they follow the topic's default. Creating, renaming and deleting a topic are on the Topics tab. Deleting a topic removes the answers stored against it.