EmailOctopus · OpenAPI Overlay 1.0.0

API Evangelist enhancements for EmailOctopus Contact API

10 actions 10 updates documentation extends openapi/emailoctopus-contact-api-openapi.yml
Derived by API Evangelist Built from the contracts EmailOctopus publishes. EmailOctopus did not publish this file.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-operation-idx-apievangelist-tagx-apievangelist-providerx-apievangelist-artifactsx-apievangelist-harvestcontacttermsOfServicex-apievangelist-conventions

Targets 9

$.info
$.servers[0]
$.paths['/lists/{list_id}/contacts'].get
$.paths['/lists/{list_id}/contacts'].put
$.paths['/lists/{list_id}/contacts'].post
$.paths['/lists/{list_id}/contacts/batch'].put
$.paths['/lists/{list_id}/contacts/{contact_id}'].get
$.paths['/lists/{list_id}/contacts/{contact_id}'].put
$.paths['/lists/{list_id}/contacts/{contact_id}'].delete

OpenAPI Overlay

Raw ↑ 
overlay: 1.0.0
info:
  title: API Evangelist enhancements for EmailOctopus Contact API
  version: 1.0.0
extends: openapi/emailoctopus-contact-api-openapi.yml
x-generated: '2026-08-13'
x-method: generated
x-source: openapi/emailoctopus-contact-api-openapi.yml + repo artifacts
actions:
- target: $.info
  update:
    x-apievangelist-provider: emailoctopus
    x-apievangelist-artifacts:
      authentication: authentication/emailoctopus-authentication.yml
      conventions: conventions/emailoctopus-conventions.yml
      errors: errors/emailoctopus-problem-types.yml
      rate-limits: rate-limits/emailoctopus-rate-limits.yml
      data-model: data-model/emailoctopus-data-model.yml
      webhooks: asyncapi/emailoctopus-webhooks.yml
      lifecycle: lifecycle/emailoctopus-lifecycle.yml
    x-apievangelist-harvest:
      source: https://emailoctopus.com/api-documentation/v2
      fetched: '2026-08-13'
      note: Split by tag from the provider-published OpenAPI 3.1.0; operationIds are the provider's own.
    contact:
      name: EmailOctopus Support
      url: https://help.emailoctopus.com
    termsOfService: https://emailoctopus.com/legal/terms
- target: $.info
  update:
    x-apievangelist-conventions:
      pagination:
        style: cursor
        params:
        - limit
        - starting_after
        max_page_size: 100
        collection_field: data
        cursor_field: paging.next.starting_after
      idempotency:
        supported: false
        note: No Idempotency-Key contract. PUT upserts are the only safe-retry path.
      errors:
        format: rfc7807
        media_type: application/json
        type_uri_prefix: https://emailoctopus.com/api-documentation/v2#
      rate_limit:
        algorithm: token-bucket
        bucket: 100
        refill_per_second: 10
        remaining_header: X-RateLimiting-Remaining
        retry_header: X-RateLimit-Retry-After
        exhausted_status: 429
- target: $.servers[0]
  update:
    description: EmailOctopus v2 production API. No version segment in the path; version is bound to the API key.
- target: $.paths['/lists/{list_id}/contacts'].get
  update:
    x-apievangelist-operation-id: api_lists_list_idcontacts_get
    x-apievangelist-tag: Contact
- target: $.paths['/lists/{list_id}/contacts'].put
  update:
    x-apievangelist-operation-id: api_lists_list_idcontacts_put
    x-apievangelist-tag: Contact
- target: $.paths['/lists/{list_id}/contacts'].post
  update:
    x-apievangelist-operation-id: api_lists_list_idcontacts_post
    x-apievangelist-tag: Contact
- target: $.paths['/lists/{list_id}/contacts/batch'].put
  update:
    x-apievangelist-operation-id: api_lists_list_idcontactsbatch_put
    x-apievangelist-tag: Contact
- target: $.paths['/lists/{list_id}/contacts/{contact_id}'].get
  update:
    x-apievangelist-operation-id: api_lists_list_idcontacts_contact_id_get
    x-apievangelist-tag: Contact
- target: $.paths['/lists/{list_id}/contacts/{contact_id}'].put
  update:
    x-apievangelist-operation-id: api_lists_list_idcontacts_contact_id_put
    x-apievangelist-tag: Contact
- target: $.paths['/lists/{list_id}/contacts/{contact_id}'].delete
  update:
    x-apievangelist-operation-id: api_lists_list_idcontacts_contact_id_delete
    x-apievangelist-tag: Contact

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay 
curl "https://apis.io/api/v1/overlays/emailoctopus-contact-overlay"
All openapi overlays 
curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.