Email & Newsletter

Buttondown + Foldr Integration

Buttondown is the minimalist newsletter service engineers love for its markdown-first editor and API. Host attachments on Foldr and reference them in Buttondown drafts — keeps email payload small and deliverable.

Buttondownvia REST APIButtondown docs

How to Connect Buttondown to Foldr

Generate a Foldr API key

Authenticate with Buttondown

Generate or locate your Buttondown API credentials per Buttondown's documentation.

Wire the two APIs together

Write a small script or serverless function that calls Buttondown, processes the result, and POSTs to https://foldr.space/api/v1/files (or /links for short links).

Deploy + schedule

Run the script on-demand, via a cron job, or trigger it from a webhook — the Foldr REST API has no client-library lock-in.

Common Use Cases

Host lead-magnet downloads on Foldr and deliver via Buttondown campaigns
Include Foldr short links in Buttondown emails for unified click tracking
Trigger Buttondown automations when a subscriber downloads a Foldr file
Run A/B tests on gated vs. open Foldr downloads in Buttondown

Buttondown + Foldr FAQ

How do I connect Foldr to Buttondown?

You connect Foldr to Buttondown via REST API. Full steps are listed above under "How to Connect". In short: create a Foldr API key, configure the REST API integration pointed at https://foldr.space/api/v1/, and map Buttondown's data into Foldr's request body.

Do I need a paid Foldr plan to use Buttondown with Foldr?

The Foldr free tier supports basic uploads via the API with 7-day expiry. For integration use with Buttondown — higher rate limits, permanent storage, multiple API keys, and webhook subscriptions — Foldr Pro (from $5/mo) is recommended.

What Foldr features can I call from Buttondown?

From Buttondown you can invoke any Foldr action: uploading files (up to 2 GB each), creating short links, generating bio pages, creating hosted forms, and reading download analytics. See the Foldr API docs for the full endpoint list.

Is there an official Foldr app for Buttondown?

Not a first-party app — Foldr integrates with Buttondown through REST API, which is usually a better fit because it doesn't require installing an extra app. If you'd rather have a native integration, let us know at foldr.space/contact.