AI agents for Buttondown

List subscribers

Lists subscribers, newest first, 100 a page, at results[].

Get a subscriber

Reads one subscriber by ID or email address: type, tags, notes, metadata, signup source and UTM fields, open_rate, click_rate, last_open_date, last_click_date and unsubscription details.

List emails

Lists the newsletter's emails, newest first, at results[]: each with id, subject, status (draft, scheduled, sent …), publish_date, absolute_url (the archive page), email_type and slug.

Get email analytics

Reads how an email did: recipients, deliveries, opens, clicks, unsubscriptions, complaints, replies, comments, temporary_failures and permanent_failures.

Add a subscriber

Adds a subscriber by email address, with tags (created when missing), private notes and metadata.

Update a subscriber

Changes a subscriber found by ID or email address: replaces its tags, notes or metadata, changes its email address, or sets its type.

Delete a subscriberDeletes data

Permanently deletes a subscriber by ID or email address, with their history.

Draft, schedule or send an email

Creates a newsletter email with a subject and a Markdown or HTML body.