Skip to Content

day3 API

The day3 API sends transactional email, keeps your users in sync with your audiences, and runs campaigns and automations. It takes and returns JSON over HTTPS, and every request authenticates with one API key.

All endpoints live under one base URL:

https://go.day3.app/api/v1

Your first request

curl https://go.day3.app/api/v1/audiences \ -H "Authorization: Bearer $DAY3_API_KEY"

A 200 with a data array means you’re set up. No key yet? The quickstart gets you from nothing to a delivered email in three steps.

Start here

Read Conventions once. Pagination, idempotency, ids and rate limits work the same on every endpoint and aren’t repeated per page.

Objects

ObjectId prefixWhat it is
Emaileml_One transactional email.
Audienceaud_A list of contacts. Everything else lives inside one.
Contactsub_A subscriber. Unique by email within an audience.
Fieldfld_A registered custom attribute key.
Segmentseg_A saved filter, evaluated live.
Topictop_A category a contact can opt out of on its own.
Campaigncmp_One email to a whole audience.
Automationaut_A published flow a contact runs through.
Suppressionsup_An account-wide “never email this address”.

What lives in the app

Sending domains, senders and OAuth clients live in the app at go.day3.app . Automations are built on the app’s canvas and only enrolled into from code. Verify a sending domain under Sending before you mail real subscribers.

Last updated on