Authenticate with 'Bearer YOUR_TOKEN' in the Authorization header.
Prepare your contact list by fetching or creating contacts with GET /contacts or POST /contacts — each contact record needs a valid handle (email address or phone number) and a 'source' type.
Create a new conversation for each contact with POST /conversations, setting the 'to' field to the contact's handle, selecting the appropriate inbox channel, and providing the 'subject' and initial message body.
To use Front Sequences (if your plan includes it), create a sequence via the Sequences API or the Front UI, then enroll contacts programmatically by POST to /sequences/{sequence_id}/contacts with the contact IDs.
Monitor conversation status and responses by listing conversations filtered by the relevant inbox using GET /conversations with 'inbox_id' and 'status' query params.
Handle opt-outs by watching for incoming replies and tagging or archiving conversations as appropriate via PATCH /conversations/{conversation_id}.
Known gotchas
Sending high volumes of outreach messages through Front in a short window may trigger spam filters at the receiving email provider — warm up sending volumes gradually.
Front Sequences is a feature tied to specific plan tiers — verify your plan includes Sequences before building automation against that endpoint.
Creating conversations via API does not guarantee immediate delivery if the channel is a connected email account with send limits; monitor send status on each conversation.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp