ActionButtondownUpdated June 2026

How do I create a Buttondown email?

Short answer: Drop the "Buttondown → Create Email / Draft" action anywhere in your workflow, map the inputs from upstream nodes, and publish.

Use this action All 2 Buttondown actions

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

Field	Type	Required	Description
Subject subject	string	Required	Message subject line.
Body body	html	Required	Message body content. Plain text unless the API specifies HTML/markdown.
Status status	options	Optional	Status. Options: Draft, Send Now

Sample request

{
  "subject": "e.g. Quick update",
  "body": "e.g. Hi there, thanks for reaching out.",
  "status": "{{trigger.status}}"
}

Returns

{
  "id": "email123",
  "status": "draft",
  "subject": "Weekly Newsletter",
  "creation_date": "2026-04-11T10:00:00Z"
}

Use these fields in downstream nodes for routing, logging, or error handling.

FAQ

Questions about Create Email / Draft.

What does the Create Email / Draft action do in Buttondown?

Creates an email — as draft for review, scheduled for later, or about_to_send for immediate delivery. Useful for "auto-publish from a Git-committed markdown file" workflows or for scheduled newsletter automation tied to publication cadence.

What inputs does Create Email / Draft require?

Required: Subject, Body. Every input accepts a static value or a variable from any upstream node in your workflow.

Can I use dynamic inputs from earlier workflow nodes?

Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.

What happens if Buttondown returns an error?

The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.

Does Create Email / Draft support batch operations?

Yes. Run Create Email / Draft inside a Loop node to process arrays. Tiny Command handles Buttondown's rate limits automatically so you don't have to throttle manually.

How do I create a Buttondown email?

The fields this action accepts.

Apps that pair well as the trigger for Create Email / Draft.

Questions about Create Email / Draft.

Other Buttondown actions.

Send create email / draft from your workflows.