DocumentationAPI Reference

Get Started

Quickstart

Get an API key and make your first request in minutes.

This gets you from an API key to your first successful request in a couple of minutes.

Before you start

  • An API key. Create one in Furnace under Account Settings → API keys and send it as Authorization: Bearer f_... (see Authentication).
  • At least one connected mailbox to send from.

1. Make your first request

List the inboxes connected to your account:

curl -sS 'https://api.getfurnace.io/v1/mailboxes' \
  -H 'Authorization: Bearer f_your_key_here'

You get back your mailboxes and their ids. Keep one id handy — a campaign sends from it.

2. Create a draft campaign

curl -sS -X POST 'https://api.getfurnace.io/v1/campaigns' \
  -H 'Authorization: Bearer f_your_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "My first campaign"
}'

This returns a campaign with status: draft. Nothing sends until you launch it.

Next

You now have an empty draft. Add an email sequence, add people, and launch it in the Campaign setup guide.