EmailOctopus Data Extractor

Vern's EmailOctopus extractor imports a new user's email data — campaigns and lists — into your product through a single managed migration, handling EmailOctopus's auth, pagination, and rate limits for you. It's built for teams onboarding customers off EmailOctopus who want their data in your app from day one.

Start migration

Browse all extractors

EmailOctopus

SaaS API (REST)

Managed auth, retries, and throttling

Normalized JSON, CSV, and DB-ready output

Cleaned JSON, CSV, and DB-ready output

Export coverage

Know exactly what Vern pulls before you migrate.

Objects Vern extracts

Vern extracts the full set of queryable EmailOctopus objects (2 total), including: Campaigns and Lists.

Output schema

Normalized JSON per object with referential keys preserved, so the relationships between your user's records survive the import. Timestamps are returned in ISO 8601. Delivered as JSON or CSV, or loaded straight into your own application database or pushed to your API — whatever your product expects.

Where it can land

Your own application database (Postgres, MySQL), a direct push to your API or webhook, or JSON/CSV files, plus another email system (BigMailer, Campaign Monitor, Campayn) when a user is switching tools.

Source details

Built for the source type shown above, with extractor content refreshed from the collection record.

Managed by Vern

The details you normally have to build yourself.

Authentication

API key / access token. Your user pastes their EmailOctopus API key once when they sign up; Vern stores it encrypted and attaches it to every request, handling header signing and retries so you never touch the raw credential. See EmailOctopus's authentication guide.

Pagination

Vern detects and handles EmailOctopus's paging model (cursor, page-number, or offset) internally and returns one consistent, de-duplicated result set — so you import a user's complete data without ever managing page tokens.

Rate limits and gotchas

EmailOctopus enforces its own API rate limits (see EmailOctopus's rate-limit docs). Vern queues and throttles requests internally so importing a new user's data never trips a 429 — even on a large account.

API-key sources rarely surface their true rate ceilings until you hit a 429 mid-import, and many silently cap page size. Vern throttles to stay under the limit and normalizes paging so a partial pull never lands a user in your product with missing data.

API quickstart

1. Create a migration for EmailOctopus
curl -X POST https://app.vern.so/api/v1/migrations \
  -H "x-api-key: $VERN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "EmailOctopus → Postgres", "source": "EmailOctopus" }'
→ { "migration_id": "mig_..." }
2. Generate the extraction recipe (pulls live via the EmailOctopus API)
curl -X POST https://app.vern.so/api/v1/migrations/$MIGRATION_ID/runs \
  -H "x-api-key: $VERN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "kind": "generate", "extract_via_api": true }'
3. Run the approved extraction
curl -X POST https://app.vern.so/api/v1/migrations/$MIGRATION_ID/runs \
  -H "x-api-key: $VERN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "kind": "execute" }'
4. Download the normalized CSV export
curl https://app.vern.so/api/v1/migrations/$MIGRATION_ID/exports/{template} \
  -H "x-api-key: $VERN_API_KEY" -o emailoctopus_export.csv

A cleaner way to extract without rebuilding source-specific plumbing.

View docs

Common questions

Can I keep a user's EmailOctopus data in sync after the first import? Vern supports re-running an import on demand; incremental change tracking depends on what EmailOctopus's API exposes for each object.

Can I move a user from EmailOctopus to BigMailer? Yes — Vern normalizes the EmailOctopus data model into typed tables that map cleanly onto BigMailer and into your own product.

What does it cost to read the EmailOctopus API? EmailOctopus's own API access follows EmailOctopus's pricing/plan; Vern is billed separately per import. Check EmailOctopus's developer docs for their current limits.