Eden Email list API
The Email list API from Eden — 5 operation(s) for email list.
Work with this as data
Every API 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 apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/eden-so:eden-so-email-list-api"
All apis
curl "https://apis.io/api/v1/apis?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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Eden store Email list API
version: 1.0.0
summary: Sales, customers, products, communities, email list, and webhooks for an Eden store.
description: 'Record sales from any checkout, give and remove access, list every sale and customer, make and publish products, post in your communities, manage the store''s email list, and get events by webhook.
**Sign in:** `Authorization: Bearer `, an Eden API key from Settings → API with Full access, or Custom with Store on Edit (Store on Read can only make GET calls). A key reaches one store, picked when it''s made. Store calls need Starter or above.
**Lists** take `limit` (1 to 100), `starting_after` (the last page''s `next_cursor`), `created_after`, and `created_before`, and answer `{ ok, data, has_more, next_cursor }`.
Your workspace (Discover, scheduling, boards, notes, Custom AIs) is a separate spec: https://mcp.eden.so/v1/openapi.json'
contact:
name: Eden
url: https://eden.so/help/api/api-reference/
termsOfService: https://eden.so/terms/
servers:
- url: https://api.eden.so
description: Eden store API
security:
- apiKey: []
tags:
- name: Email list
paths:
/store-app/v1/email-tags:
get:
operationId: getEmailTags
summary: List tags
tags:
- Email list
responses:
'200':
description: 'Done. Most answers carry `ok: true`.'
content:
application/json:
schema:
type: object
'400':
$ref: '#/components/responses/Failure'
'401':
$ref: '#/components/responses/Failure'
'402':
$ref: '#/components/responses/Failure'
'403':
$ref: '#/components/responses/Failure'
'404':
$ref: '#/components/responses/Failure'
'409':
$ref: '#/components/responses/Failure'
'422':
$ref: '#/components/responses/Failure'
'429':
$ref: '#/components/responses/Failure'
'500':
$ref: '#/components/responses/Failure'
/store-app/v1/email-contacts:
get:
operationId: getEmailContacts
summary: List email contacts
description: 'Newest first, paged. Filters: `status`, `tag`.'
tags:
- Email list
parameters:
- name: limit
in: query
required: false
schema:
anyOf:
- maxLength: 4
type: string
- type: number
- name: starting_after
in: query
required: false
schema:
maxLength: 600
type: string
- name: created_after
in: query
required: false
schema:
anyOf:
- maxLength: 64
type: string
- type: number
- name: created_before
in: query
required: false
schema:
anyOf:
- maxLength: 64
type: string
- type: number
- name: status
in: query
required: false
schema:
maxLength: 20
type: string
- name: tag
in: query
required: false
schema:
maxLength: 240
type: string
responses:
'200':
description: 'Done. Most answers carry `ok: true`.'
content:
application/json:
schema:
type: object
'400':
$ref: '#/components/responses/Failure'
'401':
$ref: '#/components/responses/Failure'
'402':
$ref: '#/components/responses/Failure'
'403':
$ref: '#/components/responses/Failure'
'404':
$ref: '#/components/responses/Failure'
'409':
$ref: '#/components/responses/Failure'
'422':
$ref: '#/components/responses/Failure'
'429':
$ref: '#/components/responses/Failure'
'500':
$ref: '#/components/responses/Failure'
post:
operationId: postEmailContacts
summary: Add a contact and tags
description: Adds the person if new, then the tags. Makes tags that don't exist yet.
tags:
- Email list
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- email
properties:
email:
minLength: 3
maxLength: 320
type: string
name:
nullable: true
anyOf:
- maxLength: 240
type: string
- type: 'null'
tags:
anyOf:
- maxLength: 2000
type: string
- maxItems: 10
type: array
items:
maxLength: 240
type: string
responses:
'200':
description: 'Done. Most answers carry `ok: true`.'
content:
application/json:
schema:
type: object
'400':
$ref: '#/components/responses/Failure'
'401':
$ref: '#/components/responses/Failure'
'402':
$ref: '#/components/responses/Failure'
'403':
$ref: '#/components/responses/Failure'
'404':
$ref: '#/components/responses/Failure'
'409':
$ref: '#/components/responses/Failure'
'422':
$ref: '#/components/responses/Failure'
'429':
$ref: '#/components/responses/Failure'
'500':
$ref: '#/components/responses/Failure'
/store-app/v1/email-sequences:
get:
operationId: getEmailSequences
summary: List sequences
description: '`starts_when` shows the tags or products each one starts on.'
tags:
- Email list
responses:
'200':
description: 'Done. Most answers carry `ok: true`.'
content:
application/json:
schema:
type: object
'400':
$ref: '#/components/responses/Failure'
'401':
$ref: '#/components/responses/Failure'
'402':
$ref: '#/components/responses/Failure'
'403':
$ref: '#/components/responses/Failure'
'404':
$ref: '#/components/responses/Failure'
'409':
$ref: '#/components/responses/Failure'
'422':
$ref: '#/components/responses/Failure'
'429':
$ref: '#/components/responses/Failure'
'500':
$ref: '#/components/responses/Failure'
/store-app/v1/email-contacts/remove-tags:
post:
operationId: postEmailContactsRemoveTags
summary: Remove tags from a contact
description: Never adds the person.
tags:
- Email list
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- email
properties:
email:
minLength: 3
maxLength: 320
type: string
tags:
anyOf:
- maxLength: 2000
type: string
- maxItems: 10
type: array
items:
maxLength: 240
type: string
responses:
'200':
description: 'Done. Most answers carry `ok: true`.'
content:
application/json:
schema:
type: object
'400':
$ref: '#/components/responses/Failure'
'401':
$ref: '#/components/responses/Failure'
'402':
$ref: '#/components/responses/Failure'
'403':
$ref: '#/components/responses/Failure'
'404':
$ref: '#/components/responses/Failure'
'409':
$ref: '#/components/responses/Failure'
'422':
$ref: '#/components/responses/Failure'
'429':
$ref: '#/components/responses/Failure'
'500':
$ref: '#/components/responses/Failure'
/store-app/v1/email-contacts/{email}:
get:
operationId: getEmailContactsEmail
summary: Get one contact
tags:
- Email list
parameters:
- name: email
in: path
required: true
schema:
minLength: 3
maxLength: 400
type: string
responses:
'200':
description: 'Done. Most answers carry `ok: true`.'
content:
application/json:
schema:
type: object
'400':
$ref: '#/components/responses/Failure'
'401':
$ref: '#/components/responses/Failure'
'402':
$ref: '#/components/responses/Failure'
'403':
$ref: '#/components/responses/Failure'
'404':
$ref: '#/components/responses/Failure'
'409':
$ref: '#/components/responses/Failure'
'422':
$ref: '#/components/responses/Failure'
'429':
$ref: '#/components/responses/Failure'
'500':
$ref: '#/components/responses/Failure'
patch:
operationId: patchEmailContactsEmail
summary: Change a contact
description: '`name`, `subscribed: false`, `add_tags`, `remove_tags`. Never turns emails back on for someone who unsubscribed, bounced, or marked spam (409).'
tags:
- Email list
parameters:
- name: email
in: path
required: true
schema:
minLength: 3
maxLength: 400
type: string
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
name:
nullable: true
anyOf:
- maxLength: 240
type: string
- type: 'null'
subscribed:
type: boolean
add_tags:
anyOf:
- maxLength: 2000
type: string
- maxItems: 10
type: array
items:
maxLength: 240
type: string
remove_tags:
anyOf:
- maxLength: 2000
type: string
- maxItems: 10
type: array
items:
maxLength: 240
type: string
responses:
'200':
description: 'Done. Most answers carry `ok: true`.'
content:
application/json:
schema:
type: object
'400':
$ref: '#/components/responses/Failure'
'401':
$ref: '#/components/responses/Failure'
'402':
$ref: '#/components/responses/Failure'
'403':
$ref: '#/components/responses/Failure'
'404':
$ref: '#/components/responses/Failure'
'409':
$ref: '#/components/responses/Failure'
'422':
$ref: '#/components/responses/Failure'
'429':
$ref: '#/components/responses/Failure'
'500':
$ref: '#/components/responses/Failure'
delete:
operationId: deleteEmailContactsEmail
summary: Remove a contact
description: 'Someone who unsubscribed or marked spam is kept (`kept: true`).'
tags:
- Email list
parameters:
- name: email
in: path
required: true
schema:
minLength: 3
maxLength: 400
type: string
responses:
'200':
description: 'Done. Most answers carry `ok: true`.'
content:
application/json:
schema:
type: object
'400':
$ref: '#/components/responses/Failure'
'401':
$ref: '#/components/responses/Failure'
'402':
$ref: '#/components/responses/Failure'
'403':
$ref: '#/components/responses/Failure'
'404':
$ref: '#/components/responses/Failure'
'409':
$ref: '#/components/responses/Failure'
'422':
$ref: '#/components/responses/Failure'
'429':
$ref: '#/components/responses/Failure'
'500':
$ref: '#/components/responses/Failure'
components:
schemas:
Failure:
type: object
required:
- ok
- error
properties:
ok:
type: boolean
const: false
error:
type: string
description: A machine code, like `product_not_found`.
message:
type: string
responses:
Failure:
description: The call failed. `error` and `message` say why.
content:
application/json:
schema:
$ref: '#/components/schemas/Failure'
securitySchemes:
apiKey:
type: http
scheme: bearer
bearerFormat: eden_pat_…
description: An Eden API key from Settings → API, or the Zapier app's OAuth token.