EmailOctopus API

14 endpoints for EmailOctopus, each at its own method and path, called with your API key. Open an endpoint for its inputs, examples and response.

Base URL
https://cotlet.dev/api/v1/emailoctopus
Connects with
Your own EmailOctopus login. What your agent can do follows your access level: an Analyst can only view reports. You sign in in your own browser and keep your 2-step verification.
Integration page
EmailOctopus

Read (6)

Return data and change nothing in the account.

EmailOctopus Endpoints: Read
EndpointDescription
GET /lists Lists of your EmailOctopus account with their subscribed, pending and unsubscribed counts.
GET /lists/{list_id}/contacts Contacts of one list with status, tags and dates, filtered by status, tag, segment or email address.
GET /lists/{list_id}/segments Saved segments of a list with the conditions each one is built from.
GET /campaigns Campaigns with status, subject, list, how many contacts they were sent to and open and click rates.
GET /campaigns/{campaign_id}/report Report of one sent campaign: sent, opened, clicked, unsubscribed, bounced and complained, plus links clicked.
GET /campaign-activities Contacts who opened, clicked, unsubscribed, bounced or complained on a campaign, or did not open or click.

Write (8)

Change the account. Calls marked Confirm wait for the user to approve them.

EmailOctopus Endpoints: Write
EndpointDescription
POST /lists/{list_id}/segments Create a reusable segment on a list from conditions on tags, fields, dates, source or campaign and contact activity.
POST /campaigns/{campaign_id}/duplicate Make a draft copy of a campaign, like Duplicate in the Campaigns tab.
PATCH /campaigns/{campaign_id} Change the name, subject, preview text or sender of a draft campaign.
PUT /lists/{list_id}/campaigns/{campaign_id}/recipients Choose who a draft campaign goes to: a whole list, a saved segment or a tag.
POST /campaigns/{campaign_id}/schedule Confirm Schedule a draft campaign for a date, time and timezone.
POST /campaigns/{campaign_id} Confirm Send a draft campaign right away.
POST /campaigns/{campaign_id}/unschedule Stop a scheduled campaign from sending, like Unschedule in the Campaigns tab.
POST /lists/{list_id}/contacts/unsubscribe Confirm Mark contacts as unsubscribed in bulk, by segment, tag or email addresses.

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.