Audience

Contacts

The people you email — created, updated, and looked up by address.

Contacts are the individuals in your audience. Create them directly, import in bulk, or let them arrive through sign-up flows.

POST/v1/contactsCreate or upsert a contact.

GET/v1/contacts/:emailLook a contact up by email address.

POST/v1/contacts/unsubscribeUnsubscribe a contact from marketing mail.

contact.ts

await mail.contacts.create({
  email: "ada@example.com",
  name: "Ada Lovelace",
  attributes: { plan: "pro", signup_source: "docs" },
});

noteYour marketing plan is priced by contact size — see Pricing.