Email Archive

⚡ Built-in — Platform Built-in

Autonomous, searchable email archives. Create archives and link mailboxes (local or external) to them as context sources, then search across the archived mail.

⚡ Built-in — No Setup Required This integration is built into the WebsitePublisher platform. All endpoints are available immediately — no API key needed.

Endpoints (11)

POST create-archive

Create a new autonomous email archive owned by an email address.

Field	Type	Required	Description
`name`	string	✓ Yes	Human-friendly archive name (e.g. "M25 mail").
`owner_email`	string	✓ Yes	Owner email address.
`description`	string	No	Optional description of what this archive holds.

GET list-archives

List archives with their source counts. Optionally filter by owner email.

Field	Type	Required	Description
`owner_email`	string	No	Filter archives by owner email.

POST deactivate-archive

Deactivate an archive. Stops syncing into it; archived messages are preserved.

Field	Type	Required	Description
`archive_id`	integer	✓ Yes	Archive ID to deactivate.

POST register-external-source

Register an external mail source (Gmail, Outlook, custom IMAP) for archiving. Credentials are stored encrypted. Link it to an archive separately with link-source.

Field	Type	Required	Description
`email`	string	✓ Yes	Mailbox email address.
`imap_host`	string	✓ Yes	IMAP server hostname (e.g. "imap.gmail.com").
`imap_port`	integer	No	IMAP port (default 993 for SSL).
`encryption`	string	No	none, ssl, or starttls (default ssl).
`auth_method`	string	No	password or oauth (default password).
`credential`	string	✓ Yes	Password or OAuth token — stored encrypted.
`folders`	array	No	Folders to sync. Leave empty to auto-discover all folders via IMAP LIST.

GET list-sources

List all archive sources (mailboxes), or the sources linked to a specific archive. Never returns credentials.

Field	Type	Required	Description
`archive_id`	integer	No	If given, list only sources linked to this archive.

POST link-source

Link a mailbox source to an archive so its mail flows into that archive. A source can feed multiple archives.

Field	Type	Required	Description
`archive_id`	integer	✓ Yes	Target archive ID.
`source_id`	integer	✓ Yes	Source (mailbox) ID to link.

POST unlink-source

Unlink a source from an archive. Stops future syncing into it; already-archived messages are preserved.

Field	Type	Required	Description
`archive_id`	integer	✓ Yes	Archive ID.
`source_id`	integer	✓ Yes	Source (mailbox) ID to unlink.

GET search

Full-text search within one archive. Combine a text query with optional filters (sender, folder, date range, attachments). Returns message metadata (no body) ordered by relevance or date.

Field	Type	Required	Description
`archive_id`	integer	✓ Yes	Archive to search within (tenant scope).
`query`	string	No	Full-text query over subject, body, recipients and attachment names. Empty = filter only.
`from_email`	string	No	Filter by exact sender email.
`folder`	string	No	Filter by IMAP folder (e.g. "INBOX").
`has_attachments`	integer	No	1 = only messages with attachments, 0 = only without.
`date_from`	string	No	Only messages received on/after this date (ISO date or unix timestamp).
`date_to`	string	No	Only messages received on/before this date (ISO date or unix timestamp).
`sort`	string	No	relevance (default), newest, or oldest.
`limit`	integer	No	Results per page (default 20, max 100).
`offset`	integer	No	Pagination offset (default 0).

GET get-message

Fetch one archived message in full (incl. body) by its archive doc id or message_id. Scoped to the given archive.

Field	Type	Required	Description
`archive_id`	integer	✓ Yes	Archive the message belongs to (tenant scope).
`id`	integer	No	Archive doc id (from a search result). Either id or message_id is required.
`message_id`	string	No	RFC Message-ID. Either id or message_id is required.

GET get-thread

Fetch all messages in a thread (by thread_id) within one archive, ordered chronologically. Metadata only — use get-message for a body.

Field	Type	Required	Description
`archive_id`	integer	✓ Yes	Archive the thread belongs to (tenant scope).
`thread_id`	string	✓ Yes	Thread identifier (from a search/message result).

GET get-stats

Aggregate statistics for one archive: message count, total size, attachment count, indexed count, date range, and per-folder counts.

Field	Type	Required	Description
`archive_id`	integer	✓ Yes	Archive to report on (tenant scope).

MCP Tool Names

When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:

Endpoint	MCP Tool Name
create-archive	`email_archive_create_archive`
list-archives	`email_archive_list_archives`
deactivate-archive	`email_archive_deactivate_archive`
register-external-source	`email_archive_register_external_source`
list-sources	`email_archive_list_sources`
link-source	`email_archive_link_source`
unlink-source	`email_archive_unlink_source`
search	`email_archive_search`
get-message	`email_archive_get_message`
get-thread	`email_archive_get_thread`
get-stats	`email_archive_get_stats`

← Back to all integrations