Maildrip API Documentation
This is the complete API documentation for connecting to the Maildrip API using MindCloud's Universal API. If you are new to MindCloud, start with the Introduction to see how one API can sit in front of many different apps.
MindCloud is an integration company that offers one normalized API to access 3,100+ apps from a single place. It cleans up provider-specific quirks, keeps requests and responses consistent, and centralizes authentication so you do not need to manage separate flows for every app. Browse other apps.
Meet Maildrip: Create campaigns, manage contacts, and automate email marketing. Keep reading to get started.
Quickstart
Before you run your first Maildrip request, you need three things:
- A MindCloud account — sign in or create an account at MindCloud.
- A MindCloud API Key — create one in API Keys. Keep it on your server.
- At least one Maildrip connection — create or choose one in Connections. Note its
connectionId.
Every Maildrip action uses the same URL pattern:
https://connect.mindcloud.co/v1/universal/maildrip/latest/actions/{actionSlug}You need a MindCloud API Key and a Maildrip connection. Then call an action such as Analyze email subject or body content and provide a performance report:
curl --request GET \
--url "https://connect.mindcloud.co/v1/universal/maildrip/latest/actions/analyze-email-subject-or-body-content-and-provide-a-performance-report" \
--header "Authorization: Bearer $MINDCLOUD_API_KEY" \
--get \
--data-urlencode "connectionId=$CONNECTION_ID"Every response comes back in the same envelope, with your rows in a data array:
{
"success": true,
"data": [
{ "id": "1042", "name": "Ava" }
],
"meta": {}
}After your first request works, use Shape your requests to control arguments, pagination, filtering, fields, and errors.
Authentication
Authentication has two layers. Your MindCloud API Key authenticates the request to MindCloud, sent as a Bearer token in the Authorization header. The connectionId selects the connected Maildrip account that should run the action. MindCloud stores and refreshes the Maildrip credentials behind that connection, so you never send provider tokens with your requests.
Pass connectionId in the query string for GET and DELETE actions, and in the JSON body for POST, PUT, and PATCH actions. Keep your MindCloud API Key on your server; do not ship it in browser code, mobile apps, public repositories, or logs.
Maildrip actions
All 167 published actions for this Maildrip version. Each page documents the endpoint, arguments, and response controls.
- POSTAdd a contact
- POSTAdd a new card for the user
- POSTAdd a new sending node to a domain group
- POSTAdd a new user to Mumara
- POSTAdd a user to the campaign
- POSTAdd an email to a campaign
- POSTAdd contact to opt-in page's groups
- POSTAdd contacts in bulk to a group
- GETAnalyze email subject or body content and provide a performance report
- POSTAtomically create a contact group and attach it to an opt-in page
- POSTAtomically create a draft campaign + draft email for an opt-in page
- POSTAuthorize a transaction
- GETCancel a subscription
- PUTCancel an active subscription for a user
- PUTChange user password
- POSTClone a public template or user-owned template
- POSTClone an instant email
- POSTCreate a new campaign
- POSTCreate a new contacts group
- POSTCreate a new opt-in page
- POSTCreate a new subscription for a user
- POSTCreate a pay-as-you-go transaction
- POSTCreate a payment intent
- POSTCreate a subscription
- POSTCreate a top-up transaction
- POSTCreate an instant email
- PUTDeactivate the account of the logged-in user
- DELETEDelete a campaign variable
- DELETEDelete a card
- DELETEDelete a contact from a specific group
- DELETEDelete a contact group
- DELETEDelete a landing page by ID
- DELETEDelete a sending domain from Mumara
- DELETEDelete a user from Mumara
- DELETEDelete a user's card
- DELETEDelete an attachment from a email
- DELETEDelete an email from a campaign
- DELETEDelete an opt-in page by ID
- DELETEDelete campaign
- DELETEDelete instant email by ID
- DELETEDelete user from campaign
- POSTDuplicate an existing campaign
- PUTEdit a contact
- PUTEdit campaign variables
- PUTEdit instant email
- POSTExecute an MCP tool
- PUTFix and optimize manual email content using AI and analysis report (paid users only)
- POSTGenerate a new AI email template from a natural language prompt
- POSTGenerate email subject or body content using AI
- GETGet a published opt-in page by ID (public, no auth required)
- GETGet account health status
- GETGet AI assistant capabilities
- GETGet all active promos
- GETGet all available plans
- GETGet all available subscription plans with IDs
- GETGet all contact groups
- GETGet all distinct metadata attribute keys for user's contacts
- GETGet an email by ID for a specific campaign
- GETGet an opt-in page by ID
- GETGet API credentials
- GETGet campaign variables
- GETGet contact count by attribute filters
- GETGet contact counts for an opt-in page's linked groups
- GETGet contacts in a specific group or all contacts
- GETGet details about a specific tool
- GETGet details of a specific sending node
- GETGet emails for a specific recipient in a campaign
- GETGet instant email by ID
- GETGet landing page by ID
- GETGet landing page details for a campaign
- GETGet landing pages
- GETGet MCP server information and capabilities
- GETGet opt-in pages
- GETGet page, setup, checklist, and stats in a single call
- GETGet pre-publish checklist for an opt-in page
- GETGet promo pricing for a plan (public - all users see promo prices)
- GETGet public templates with filtering and sorting
- GETGet segment statistics
- GETGet sending domains from Mumara
- GETGet suggested prompts for the chat interface
- GETGet top-up rate
- GETGet updated pay-as-you-go rate
- GETGet user details
- GETGet user transactions
- GETGet user's saved cards from Paystack
- GETGet UTM attribution breakdown for an opt-in page's signups
- POSTGoogle OAuth signup or login
- POSTIdentify a contact and sync attributes from your app
- POSTImport contact groups to an instant email
- POSTImport contacts from groups to a campaign
- POSTImport contacts to a campaign
- POSTImport CSV contacts to an instant email
- POSTIteratively improve an existing AI-generated email template
- POSTJoin a campaign as a guest
- GETList all available MCP tools
- POSTLogin to the application
- POSTManually regenerate AI review (costs 5 AI credits)
- POSTManually trigger segment re-evaluation
- PUTModify contacts by adding them to specified groups and optionally to a campaign.
- PUTPartially update an opt-in page (e.g. rename)
- POSTPerform a detailed analysis of email content and provide manual recommendations (paid users only)
- POSTPlatform-internal identify — sync dashboard user attributes
- GETPreview contacts in segment for campaign
- GETPreview segment membership without saving
- PUTPublish an opt-in page
- PUTReactivate a canceled subscription for a user
- POSTReactivate a deactivated account
- POSTReceive webhook from Mumara
- POSTRecord promo usage when user subscribes
- POSTRegister a new user
- DELETERemove contacts from a group or delete them entirely (asynchronous).
- PUTRename a user-owned template
- PUTReorder emails in a campaign
- POSTResend verification email
- POSTReset password using the reset password hash
- PUTRestore draft email to drafts
- GETRestore draft email to editing
- GETRetrieve a campaign by ID
- GETRetrieve active emails of a campaign
- GETRetrieve campaigns
- GETRetrieve data of a campaign
- GETRetrieve deleted emails of a campaign
- GETRetrieve draft emails of a campaign
- GETRetrieve instant emails
- GETRetrieve sending nodes from Mumara
- GETRetrieve the user's saved cards
- GETRetrieve User Templates
- GETRetrieve users associated with a campaign
- PUTSave email as draft
- PUTSave email draft for a campaign
- POSTSend a chat message to the AI assistant
- POSTSend a test mail for an instant email
- POSTSend a test mail for the campaign
- POSTSend a transactional email using a template
- POSTSend a transactional email with raw data
- DELETESend email to trash
- POSTSend email via Mumara
- POSTSend onboarding test mail using dedicated test domains
- POSTSend reset password email
- PUTSet a card as default
- PUTSet a user's card as the default card
- PUTSet campaign to target a dynamic segment
- POSTSubmit an appeal for account blocking
- PUTToggle template public/private (triggers AI review on first publish)
- POSTTop up subscription wallet
- PUTUnpublish an opt-in page
- PUTUpdate a user in Mumara
- PUTUpdate a user's subscription plan
- PUTUpdate account settings for the logged-in user
- PUTUpdate campaign interval
- PUTUpdate campaign status
- PUTUpdate contact group description
- PUTUpdate email configuration for a campaign
- PUTUpdate email content for a campaign
- PUTUpdate email settings for the logged-in user
- PUTUpdate landing page details for a campaign
- PUTUpdate metadata attributes for multiple contacts
- PUTUpdate sending node status
- PUTUpdate subscription plan
- PUTUpdate the low credit limit for email credits
- POSTUpload attachment To An Email
- POSTUpload image for an opt-in page
- POSTUpload profile photo for the user
- POSTValidate a payment intent
- GETVerify a Paystack transaction
- GETVerify domain DNS records
- GETVerify the setup health of an opt-in page
Related apps
More Marketing apps on the Universal API, behind the same REST shape. Or browse all apps.