Email providers

An email provider is a sending mailbox connected to Emelia: a Google or Microsoft account, or any SMTP and IMAP mailbox. Campaigns send from them, through the identities of each campaign.

List your mailboxesCopy Anchor Link

curl https://api.emelia.io/email-providers \
  -H "Authorization: $EMELIA_API_KEY"

Each mailbox comes with the campaigns that use it. Passwords are always masked (********). There is no pagination: you get every mailbox in one response. The _id is what you put in identities[].email of a campaign.

Connect an SMTP and IMAP mailboxCopy Anchor Link

curl -X POST https://api.emelia.io/email-providers \
  -H "Authorization: $EMELIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "senderName": "Marie Martin",
    "senderEmail": "marie.martin@yourcompany.com",
    "emailType": "SMTP",
    "smtp": { "login": "marie.martin@yourcompany.com", "password": "app-password", "server": "smtp.yourcompany.com", "port": 465, "ssl": true },
    "imap": { "login": "marie.martin@yourcompany.com", "password": "app-password", "server": "imap.yourcompany.com", "port": 993, "ssl": true }
  }'

Emelia tests the SMTP and IMAP credentials before saving the mailbox. The number of mailboxes is limited by your plan. Google and Microsoft accounts are connected in the Emelia app, with their own sign in.

To fix the credentials of a disconnected mailbox, use Update a mailbox: masked passwords (********) are kept as stored. Change the sender name works on every type of mailbox, without a new test.

WarmupCopy Anchor Link

Warmup builds the sending reputation of a mailbox before and while it prospects.

curl -X POST https://api.emelia.io/email-providers/warmup/enable \
  -H "Authorization: $EMELIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"providerId": "6650f1a2b839d80011c5a0aa"}'

• Enabling the warmup needs an active subscription. providerId takes the id of the mailbox or of its warmup.
• Some hosts cannot be warmed up: the call fails with WARMUP_PROVIDER_UNSUPPORTED.
• GET /email-providers/warmup returns the state of every mailbox (running or not, statistics, diagnosis), without pagination: a page parameter is ignored. The _id of an item is the warmup id.
• To turn a warmup off, use the Emelia app.

Deliverability diagnosisCopy Anchor Link

Asks for a new DNS, sending and blacklist diagnosis of a mailbox, from its warmup id ({"warmupId": "..."}). The result appears a few minutes later in health of GET /email-providers/warmup. This route answers its errors as {"success": false, "message": "..."}.

Remove a mailboxCopy Anchor Link

Removes the mailbox from your account. Detach it from your running campaigns first, with Set the sender identities.