Automate your agency workspace. All endpoints are scoped to the agency that owns the API key.
Bearer token in the Authorization header.
curl https://api.postcardpilot.com/v1/clients \ -H "Authorization: Bearer live_xxxxxxxxxxxxxxxx"
Create keys under Agency → Developers → API Keys.
Per API key.
Retry-After header./v1/clientsList clients in your agency.
/v1/clientsCreate a client.
/v1/clients/:idUpdate a client.
/v1/campaignsList campaigns (filter by client_id).
/v1/campaignsCreate a campaign draft.
/v1/campaigns/:id/sendSchedule a campaign to send.
/v1/mail-pieces/:idGet status of a single mail piece.
/v1/audiencesList saved audiences.
/v1/audiences/from-listCreate an audience from a mailing list.
/v1/designs/generateGenerate a postcard design (AI).
/v1/usageCurrent period volume + spend.
Signed with HMAC-SHA256 in X-PostcardPilot-Signature.
X-PostcardPilot-Signature: t=1737244800,v1=<hex-hmac-of "t.body">
Deliveries are retried with backoff up to 6 attempts (30s → 2m → 10m → 1h → 6h → 24h) before dead-lettering.