Buttondown platform help — newsletter publishing, paid subscriptions via Stripe, automations, subscriber management, tags, RSS-to-email, custom domains, Markdown editor, CLI, REST API. Use when Buttondown emails aren't sending, paid subscriptions not working, automation not triggering, subscribers not importing, Stripe payments failing, custom domain not resolving, API calls returning errors, or migrating to Buttondown from another platform. Do NOT use for cross-platform email marketing strategy (use /sales-email-marketing), newsletter monetization strategy (use /sales-newsletter), audience growth strategy (use /sales-audience-growth), or cross-platform deliverability (use /sales-deliverability).
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Buttondown platform help — newsletter publishing, paid subscriptions via Stripe, automations, subscriber management, tags, RSS-to-email, custom domains, Markdown editor, CLI, REST API. Use when Buttondown emails aren't sending, paid subscriptions not working, automation not triggering, subscribers not importing, Stripe payments failing, custom domain not resolving, API calls returning errors, or migrating to Buttondown from another platform. Do NOT use for cross-platform email marketing strategy (use /sales-email-marketing), newsletter monetization strategy (use /sales-newsletter), audience growth strategy (use /sales-audience-growth), or cross-platform deliverability (use /sales-deliverability).
Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2.
Step 2 — Route or answer directly
If the question is about...
Hand off
Email marketing strategy across tools
"This is an email marketing strategy question — run: /sales-email-marketing {your question}"
Newsletter monetization strategy
"This is a newsletter monetization question — run: /sales-newsletter {your question}"
Growing your subscriber list
"This is an audience growth question — run: /sales-audience-growth {your question}"
Deliverability, SPF/DKIM/DMARC
"This is a deliverability question — run: /sales-deliverability {your question}"
Connecting Buttondown to other tools
"This is a tool integration question — run: "
/sales-integration {your question}
Answer directly when the question is Buttondown-specific — platform config, UI navigation, API usage, Stripe setup, add-on features.
Step 3 — Buttondown platform reference
Read references/platform-guide.md for the full platform reference — modules, pricing, integrations, data model, workflows.
Answer the user's question using only the relevant section. Don't dump the full reference.
Step 4 — Actionable guidance
You no longer need the platform guide — focus on the user's specific situation.
Provide step-by-step instructions with:
Exact navigation — where to click in the Buttondown dashboard
Settings to configure — specific fields, values, toggles
Plan requirements — flag if a feature requires an add-on or higher plan
Verification steps — how to confirm it's working
If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.
Gotchas
Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.
Most features are paid add-ons — tagging, analytics, paid subscriptions, automations, and RSS-to-email each cost $9-$29/mo extra on top of the base plan. Don't assume a feature is available — check which add-ons the user has enabled.
Sending limit assumes daily max — pricing is based on sending at most one email per day to your entire subscriber base. If you need higher frequency, contact Buttondown for custom pricing.
Automations add-on is $29/mo — unlike Kit or Mailchimp where automations are included, Buttondown charges separately. Welcome sequences require this add-on.
API is available on all plans including free — unlike many competitors, even free-tier users can use the full REST API. Auth is Authorization: Token {key} with base URL https://api.buttondown.com/v1/. Manage keys at buttondown.com/keys (API → Keys; granular multiple keys supported). Rate limits: 600 req/min globally; subscriber creation is capped at 100/day (returns 400 — bulk-import larger lists). The create-subscriber body uses email_address (not email).
Concierge migration is free — Buttondown migrates your subscriber list from any platform at no cost, usually within one business day. Don't try to do complex migrations manually.
/sales-kit — Kit (formerly ConvertKit) platform help — direct competitor
/sales-ghost — Ghost platform help — newsletter + publishing alternative
/sales-mailerlite — MailerLite platform help — affordable newsletter alternative
/sales-digital-products — Selling digital products alongside your newsletter
/sales-integration — Connect Buttondown to CRM and other tools via API, Zapier, webhooks
/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-do
Examples
Example 1: Setting up paid subscriptions
User says: "How do I charge for my newsletter on Buttondown?"
Skill does: Walks through enabling the Paid Subscriptions add-on, connecting Stripe, configuring pricing tiers, and setting up paywalled content with the paywall toggle
Result: User has a working paid newsletter with Stripe payments
Example 2: Migrating from Substack
User says: "I want to move my 2,000 subscribers from Substack to Buttondown"
Skill does: Recommends using Buttondown's free concierge migration service, explains what transfers (subscribers, archives), flags what doesn't (Substack-specific features like Notes), and covers domain authentication setup
Result: User has a migration plan with zero subscriber loss
Example 3: API integration
User says: "I want to automatically add subscribers from my app to Buttondown"
Skill does: Provides the POST /v1/subscribers endpoint with auth header, request body format, and example cURL/Python code. Covers tag assignment and metadata fields
Result: User has working API integration code
Troubleshooting
Paid subscriptions not collecting payment
Symptom: Paywall is enabled but readers can't pay or see no payment option
Cause: Stripe not connected, or Paid Subscriptions add-on not enabled
Solution: Go to Settings → Paid Subscriptions, verify the add-on is active ($9/mo), and check Stripe connection status. Test with a Stripe test-mode payment. Ensure the email has the paywall toggle enabled.
Emails stuck in draft or not sending
Symptom: Email shows as draft but won't send, or scheduled send didn't fire
Cause: Email may be flagged by Buttondown's built-in checks (broken links, malformed images), or sending domain not verified
Solution: Check the email's status page for warnings. Verify your sending domain in Settings → Domains. If using a custom domain, confirm DNS records (SPF/DKIM) are propagated.
Subscribers not appearing after import
Symptom: Imported a CSV but subscriber count didn't change
Cause: CSV format issues, duplicate emails, or import still processing
Solution: Check import status in Subscribers → Imports. Verify CSV has a column header named "email" (case-sensitive). Duplicates are silently skipped. Large imports may take several minutes.
