# mave.postbox

> The affordable newsletter for the agentic era: a newsletter app where you pay for the emails you send, not for dormant subscribers, for a fraction of what other platforms charge. Send Emails, your own HTML as it is, or write Posts in the newsletter's design for its emails and website; schedule them, send them to your list, from the dashboard, or let an AI agent do it: everything a customer does in the dashboard also works through a REST API and an MCP server, with the same checks and limits.

REST API: https://postbox.mave.digital/api/v1, with Authorization: Bearer <API key>. MCP server (Streamable HTTP): https://postbox.mave.digital/mcp, same key, or OAuth for apps like ChatGPT, Claude and Grok Bot.

## API and MCP

- [Getting started](https://postbox.mave.digital/docs): Make a first request and connect an AI assistant.
- [Authentication](https://postbox.mave.digital/docs/authentication): API keys, their two levels and the rate limits.
- [Errors](https://postbox.mave.digital/docs/errors): The error shape and every code.
- [MCP](https://postbox.mave.digital/docs/mcp): The MCP server, its tools and setup for ChatGPT, Claude, Grok Bot, Claude Code, Codex and Cursor.
- [API reference](https://postbox.mave.digital/docs/api): Every endpoint with its parameters and an example.
- [OpenAPI document](https://postbox.mave.digital/api/v1/openapi.json): the API as OpenAPI 3.1.
- [Full reference](https://postbox.mave.digital/llms-full.txt): every endpoint and MCP tool in Markdown.

## Help

How mave.postbox works, for the people who use it.

- [Getting started](https://postbox.mave.digital/help/getting-started): Sign in, set up your newsletter, choose its design, send your first issue and follow its numbers on the overview.
- [Newsletter settings](https://postbox.mave.digital/help/newsletters): Name, sender, website, signups and the emails new subscribers get.
- [Sender addresses and domains](https://postbox.mave.digital/help/sender-addresses): Send from the shared address, or from your own domain once its DNS records are in, and what happens when one changes.
- [Website and signups](https://postbox.mave.digital/help/website): Each newsletter's website, its issue pages, and how people sign up.
- [Website analytics](https://postbox.mave.digital/help/website-analytics): Google Analytics, Tag Manager, the Meta pixel and your own code on your website: where each ID is and how to check it works.
- [Team members](https://postbox.mave.digital/help/team): Invite people to a newsletter as admins or members, what each can do, writing a draft together, and removing them.
- [Design and themes](https://postbox.mave.digital/help/design): Pick a theme for your website and emails, then change its colors, fonts and shapes.
- [Contacts](https://postbox.mave.digital/help/contacts): Statuses, selecting many at once, each contact's page, first names, tags and fields, segments, the ways to add people, exports and deleting.
- [Importing contacts](https://postbox.mave.digital/help/importing-contacts): Bring your list from another platform as a CSV file, with names, tags and fields, and what the import leaves out.
- [List cleanup](https://postbox.mave.digital/help/list-cleanup): What happens to contacts who stop opening: a last-chance email, then dormant.
- [Writing an issue](https://postbox.mave.digital/help/writing): The editor, the author, pictures, buttons, HTML blocks, moving and deleting blocks, names and fields, sections for some readers, the footer, the preview and test emails.
- [Sending and scheduling](https://postbox.mave.digital/help/sending): The checks before sending, email, web or both, send now or later, who gets it, first sends in steps and reports.
- [Bounces, complaints and pauses](https://postbox.mave.digital/help/deliverability): What bounces and spam complaints do, when a send pauses, when an account is blocked, and a test in spam.
- [API and AI assistants](https://postbox.mave.digital/help/api-and-ai): Run everything from code, or from ChatGPT, Claude and other assistants.
- [Your account](https://postbox.mave.digital/help/account): Signing in, connected apps, and deleting or restoring your account.
- [Notifications](https://postbox.mave.digital/help/notifications): The bell in the dashboard: what needs you, like a paused campaign, and news, like a finished import.

## Endpoints

### Overview

- [Get the overview](https://postbox.mave.digital/docs/api#get-overview): GET /api/v1/overview (MCP tool get_overview)
- [Get a summary](https://postbox.mave.digital/docs/api#get-summary): GET /api/v1/summary (MCP tool get_summary)

### Newsletters

- [List newsletters](https://postbox.mave.digital/docs/api#list-newsletters): GET /api/v1/newsletters (MCP tool list_newsletters)
- [Get a newsletter](https://postbox.mave.digital/docs/api#get-newsletter): GET /api/v1/newsletters/{id} (MCP tool get_newsletter)
- [Create a newsletter](https://postbox.mave.digital/docs/api#create-newsletter): POST /api/v1/newsletters (MCP tool create_newsletter)
- [Update a newsletter](https://postbox.mave.digital/docs/api#update-newsletter): PATCH /api/v1/newsletters/{id} (MCP tool update_newsletter)
- [List themes](https://postbox.mave.digital/docs/api#list-themes): GET /api/v1/themes (MCP tool list_themes)
- [Get the signup form](https://postbox.mave.digital/docs/api#get-signup-form): GET /api/v1/newsletters/{id}/signup-form (MCP tool get_signup_form)
- [Check a slug](https://postbox.mave.digital/docs/api#check-newsletter-slug): GET /api/v1/newsletters/slugs/{slug} (MCP tool check_newsletter_slug)
- [Send a test of the welcome email](https://postbox.mave.digital/docs/api#send-welcome-test-email): POST /api/v1/newsletters/{id}/welcome-test (MCP tool send_welcome_test_email)
- [Set the website's domain](https://postbox.mave.digital/docs/api#set-website-domain): POST /api/v1/newsletters/{id}/website-domain (MCP tool set_website_domain)
- [Check the website's domain](https://postbox.mave.digital/docs/api#check-website-domain): POST /api/v1/newsletters/{id}/website-domain/check (MCP tool check_website_domain)
- [Remove the website's domain](https://postbox.mave.digital/docs/api#remove-website-domain): DELETE /api/v1/newsletters/{id}/website-domain (MCP tool remove_website_domain)

### Team

- [List team members](https://postbox.mave.digital/docs/api#list-team-members): GET /api/v1/newsletters/{id}/team (MCP tool list_team_members)
- [Invite a team member](https://postbox.mave.digital/docs/api#invite-team-member): POST /api/v1/newsletters/{id}/team (MCP tool invite_team_member)
- [Update a team member](https://postbox.mave.digital/docs/api#update-team-member): PATCH /api/v1/newsletters/{id}/team/{memberId} (MCP tool update_team_member)
- [Remove a team member](https://postbox.mave.digital/docs/api#remove-team-member): DELETE /api/v1/newsletters/{id}/team/{memberId} (MCP tool remove_team_member)

### Notifications

- [List notifications](https://postbox.mave.digital/docs/api#list-notifications): GET /api/v1/notifications (MCP tool list_notifications)
- [Mark notifications read](https://postbox.mave.digital/docs/api#mark-notifications-read): POST /api/v1/notifications/read (MCP tool mark_notifications_read)
- [Clear notifications](https://postbox.mave.digital/docs/api#clear-notifications): POST /api/v1/notifications/clear (MCP tool clear_notifications)
- [Preview the summary email](https://postbox.mave.digital/docs/api#preview-summary-email): GET /api/v1/summary/preview (MCP tool preview_summary_email)
- [Send an inbox check email](https://postbox.mave.digital/docs/api#send-inbox-check-email): POST /api/v1/inbox-check (MCP tool send_inbox_check_email)

### Campaigns

- [List campaigns](https://postbox.mave.digital/docs/api#list-campaigns): GET /api/v1/campaigns (MCP tool list_campaigns)
- [Get a campaign](https://postbox.mave.digital/docs/api#get-campaign): GET /api/v1/campaigns/{id} (MCP tool get_campaign)
- [Get a campaign's report](https://postbox.mave.digital/docs/api#get-campaign-report): GET /api/v1/campaigns/{id}/report (MCP tool get_campaign_report)
- [List a campaign's recipients](https://postbox.mave.digital/docs/api#list-campaign-recipients): GET /api/v1/campaigns/{id}/recipients (MCP tool list_campaign_recipients)
- [Create a draft campaign](https://postbox.mave.digital/docs/api#create-campaign): POST /api/v1/campaigns (MCP tool create_campaign)
- [Update a draft campaign](https://postbox.mave.digital/docs/api#update-campaign): PATCH /api/v1/campaigns/{id} (MCP tool update_campaign)
- [Delete a draft campaign](https://postbox.mave.digital/docs/api#delete-campaign): DELETE /api/v1/campaigns/{id} (MCP tool delete_campaign)
- [Duplicate a campaign](https://postbox.mave.digital/docs/api#duplicate-campaign): POST /api/v1/campaigns/{id}/duplicate (MCP tool duplicate_campaign)
- [Preview a campaign](https://postbox.mave.digital/docs/api#preview-campaign): GET /api/v1/campaigns/{id}/preview (MCP tool preview_campaign)
- [Count who sees a campaign's sections](https://postbox.mave.digital/docs/api#count-section-readers): POST /api/v1/campaigns/{id}/sections/count (MCP tool count_section_readers)
- [Send a test email](https://postbox.mave.digital/docs/api#send-test-email): POST /api/v1/campaigns/{id}/test (MCP tool send_test_email)
- [Get tips for a campaign](https://postbox.mave.digital/docs/api#get-campaign-tips): GET /api/v1/campaigns/{id}/tips (MCP tool get_campaign_tips)
- [Schedule a campaign](https://postbox.mave.digital/docs/api#schedule-campaign): POST /api/v1/campaigns/{id}/schedule (MCP tool schedule_campaign)
- [Cancel a scheduled send](https://postbox.mave.digital/docs/api#unschedule-campaign): POST /api/v1/campaigns/{id}/unschedule (MCP tool unschedule_campaign)
- [Send a campaign now](https://postbox.mave.digital/docs/api#send-campaign): POST /api/v1/campaigns/{id}/send (MCP tool send_campaign)
- [Send a campaign to more contacts](https://postbox.mave.digital/docs/api#send-campaign-to-more): POST /api/v1/campaigns/{id}/send-more (MCP tool send_campaign_to_more)
- [Pause a campaign](https://postbox.mave.digital/docs/api#pause-campaign): POST /api/v1/campaigns/{id}/pause (MCP tool pause_campaign)
- [Resume a paused campaign](https://postbox.mave.digital/docs/api#resume-campaign): POST /api/v1/campaigns/{id}/resume (MCP tool resume_campaign)
- [Update a campaign's archive page](https://postbox.mave.digital/docs/api#update-campaign-archive): PATCH /api/v1/campaigns/{id}/archive (MCP tool update_campaign_archive)
- [Remove a campaign from the website](https://postbox.mave.digital/docs/api#unpublish-campaign): POST /api/v1/campaigns/{id}/unpublish (MCP tool unpublish_campaign)
- [Preview the list cleanup of a send](https://postbox.mave.digital/docs/api#preview-campaign-cleanup): GET /api/v1/campaigns/{id}/cleanup-preview (MCP tool preview_campaign_cleanup)

### Authors

- [List authors](https://postbox.mave.digital/docs/api#list-authors): GET /api/v1/authors (MCP tool list_authors)
- [Add an author](https://postbox.mave.digital/docs/api#create-author): POST /api/v1/authors (MCP tool create_author)
- [Update an author](https://postbox.mave.digital/docs/api#update-author): PATCH /api/v1/authors/{id} (MCP tool update_author)
- [Remove an author](https://postbox.mave.digital/docs/api#delete-author): DELETE /api/v1/authors/{id} (MCP tool delete_author)

### Contacts

- [List contacts](https://postbox.mave.digital/docs/api#list-contacts): GET /api/v1/contacts (MCP tool list_contacts)
- [Search contacts](https://postbox.mave.digital/docs/api#search-contacts): GET /api/v1/contacts/search (MCP tool search_contacts)
- [Get a contact](https://postbox.mave.digital/docs/api#get-contact): GET /api/v1/contacts/{id} (MCP tool get_contact)
- [List a contact's emails](https://postbox.mave.digital/docs/api#list-contact-emails): GET /api/v1/contacts/{id}/emails (MCP tool list_contact_emails)
- [Add a contact](https://postbox.mave.digital/docs/api#add-contact): POST /api/v1/contacts (MCP tool add_contact)
- [Update a contact](https://postbox.mave.digital/docs/api#update-contact): PATCH /api/v1/contacts/{id}/details (MCP tool update_contact)
- [Change a contact's status](https://postbox.mave.digital/docs/api#update-contact-status): PATCH /api/v1/contacts/{id} (MCP tool update_contact_status)
- [Change contacts' status](https://postbox.mave.digital/docs/api#update-contacts-status): POST /api/v1/contacts/status (MCP tool update_contacts_status)
- [Tag contacts](https://postbox.mave.digital/docs/api#tag-contacts): POST /api/v1/contacts/tag (MCP tool tag_contacts)
- [Untag contacts](https://postbox.mave.digital/docs/api#untag-contacts): POST /api/v1/contacts/untag (MCP tool untag_contacts)
- [Delete a contact](https://postbox.mave.digital/docs/api#delete-contact): DELETE /api/v1/contacts/{id} (MCP tool delete_contact)
- [Delete contacts](https://postbox.mave.digital/docs/api#delete-contacts): POST /api/v1/contacts/delete (MCP tool delete_contacts)
- [Import contacts](https://postbox.mave.digital/docs/api#import-contacts): POST /api/v1/contacts/import (MCP tool import_contacts)
- [Get an import](https://postbox.mave.digital/docs/api#get-import): GET /api/v1/contacts/imports/{id} (MCP tool get_import)
- [List imports](https://postbox.mave.digital/docs/api#list-imports): GET /api/v1/contacts/imports (MCP tool list_imports)
- [List left-out contacts](https://postbox.mave.digital/docs/api#list-left-out): GET /api/v1/contacts/imports/{id}/left-out (MCP tool list_left_out)
- [Bring back left-out contacts](https://postbox.mave.digital/docs/api#bring-back-contacts): POST /api/v1/contacts/imports/{id}/left-out (MCP tool bring_back_contacts)
- [Export contacts](https://postbox.mave.digital/docs/api#export-contacts): GET /api/v1/contacts/export (MCP tool export_contacts)
- [List tags](https://postbox.mave.digital/docs/api#list-contact-tags): GET /api/v1/contacts/tags (MCP tool list_contact_tags)
- [List contact sources](https://postbox.mave.digital/docs/api#list-contact-sources): GET /api/v1/contacts/sources (MCP tool list_contact_sources)
- [List contact fields](https://postbox.mave.digital/docs/api#list-contact-fields): GET /api/v1/contacts/fields (MCP tool list_contact_fields)
- [Create a contact field](https://postbox.mave.digital/docs/api#create-contact-field): POST /api/v1/contacts/fields (MCP tool create_contact_field)
- [Delete a contact field](https://postbox.mave.digital/docs/api#delete-contact-field): DELETE /api/v1/contacts/fields/{key} (MCP tool delete_contact_field)

### Segments

- [List segments](https://postbox.mave.digital/docs/api#list-segments): GET /api/v1/segments (MCP tool list_segments)
- [Get a segment](https://postbox.mave.digital/docs/api#get-segment): GET /api/v1/segments/{id} (MCP tool get_segment)
- [Count a segment's contacts](https://postbox.mave.digital/docs/api#count-segment): POST /api/v1/segments/count (MCP tool count_segment)
- [Create a segment](https://postbox.mave.digital/docs/api#create-segment): POST /api/v1/segments (MCP tool create_segment)
- [Update a segment](https://postbox.mave.digital/docs/api#update-segment): PATCH /api/v1/segments/{id} (MCP tool update_segment)
- [Delete a segment](https://postbox.mave.digital/docs/api#delete-segment): DELETE /api/v1/segments/{id} (MCP tool delete_segment)

### Domains

- [List domains](https://postbox.mave.digital/docs/api#list-domains): GET /api/v1/domains (MCP tool list_domains)
- [Add a domain](https://postbox.mave.digital/docs/api#add-domain): POST /api/v1/domains (MCP tool add_domain)
- [Check a domain's DNS records](https://postbox.mave.digital/docs/api#check-domain): POST /api/v1/domains/{id}/check (MCP tool check_domain)
- [Remove a domain](https://postbox.mave.digital/docs/api#remove-domain): DELETE /api/v1/domains/{id} (MCP tool remove_domain)

### Images

- [List images](https://postbox.mave.digital/docs/api#list-images): GET /api/v1/images (MCP tool list_images)
- [Upload an image](https://postbox.mave.digital/docs/api#upload-image): POST /api/v1/images (MCP tool upload_image)

### API keys

- [List API keys](https://postbox.mave.digital/docs/api#list-api-keys): GET /api/v1/api-keys (MCP tool list_api_keys)
- [Create an API key](https://postbox.mave.digital/docs/api#create-api-key): POST /api/v1/api-keys (MCP tool create_api_key)
- [Revoke an API key](https://postbox.mave.digital/docs/api#revoke-api-key): DELETE /api/v1/api-keys/{id} (MCP tool revoke_api_key)
- [List connected apps](https://postbox.mave.digital/docs/api#list-connected-apps): GET /api/v1/connected-apps (MCP tool list_connected_apps)
- [Disconnect an app](https://postbox.mave.digital/docs/api#revoke-connected-app): DELETE /api/v1/connected-apps/{id} (MCP tool revoke_connected_app)

### Billing

- [Get the plan and usage](https://postbox.mave.digital/docs/api#get-billing): GET /api/v1/billing (MCP tool get_billing)
- [Change plan](https://postbox.mave.digital/docs/api#change-plan): POST /api/v1/billing/change-plan (MCP tool change_plan)
- [Open the billing portal](https://postbox.mave.digital/docs/api#open-billing-portal): POST /api/v1/billing/portal (MCP tool open_billing_portal)