API documentation

Complete API reference for the EmailList API. Build powerful email list management into your application.

Integration walkthrough

Step-by-step guide to integrating EmailList into your application

Getting started

Installation instructions and authentication setup

Projects

Manage projects and organize your email lists

Lists

Create and manage email lists within projects

Contacts

Manage contacts and subscriber information

List contacts

Add and remove contacts from lists

Bulk operations

Efficiently create multiple contacts at once

Unsubscribe URLs

Complete guide on how to get and use unsubscribe URLs in your email templates

Ruby SDK

Rails integration and automatic contact syncing

Base URL

https://emaillist.dev/api/v1

All API requests should be made to this base URL.

Authentication

All API requests require authentication. You can authenticate using one of these methods:

Authorization header (recommended):

Authorization: Bearer YOUR_API_KEY

X-API-Key header:

X-API-Key: YOUR_API_KEY

Query string parameter:

?api_key=YOUR_API_KEY

Note: Query string parameters may be logged in server logs. For production, prefer header-based authentication.

You can generate API keys in your dashboard by navigating to Settings → API keys.