All endpoints
Every route of the Emelia API on one page, grouped by topic, with a link to its reference page and playground, and the OpenAPI specs to download.
Every route below has its own page, under its topic in the menu: parameters, request body, responses with realistic examples, code in cURL, JavaScript and Python, and a playground to send real requests with your key.
Emelia API
https://api.emelia.io128 routes, 5 webhook events. Header: Authorization: YOUR_API_KEY
Emelia Inbox API
https://api.emelia.io/inbox/api/v141 routes, 6 webhook events. Header: Authorization: YOUR_API_KEY
The specs are OpenAPI 3.1 files: import them in Postman or Insomnia, generate a client, or give them to an AI agent.
Emelia API
- GET
/advanced/campaignsList campaigns - POST
/advanced/campaignsCreate a campaign - GET
/advanced/campaigns/{campaignId}Get a campaign - PATCH
/advanced/campaigns/{campaignId}/stepsReplace the sequence - PATCH
/advanced/campaigns/{campaignId}/settingsUpdate campaign settings - PATCH
/advanced/campaigns/{campaignId}/identitiesSet the sender identities - PATCH
/advanced/campaigns/{campaignId}/recipientsSet the contact lists of a campaign - POST
/advanced/campaigns/{campaignId}/test-emailSend a test email - POST
/advanced/campaigns/{campaignId}/startStart a campaign - PATCH
/advanced/campaigns/{campaignId}/planned-startSchedule or cancel a planned start - POST
/advanced/campaigns/{campaignId}/pausePause a campaign - POST
/advanced/campaigns/{campaignId}/finishMark a campaign as finished - POST
/advanced/campaigns/{campaignId}/reactivateReactivate a finished campaign - PATCH
/advanced/campaigns/{campaignId}/nameRename a campaign - POST
/advanced/campaigns/{campaignId}/duplicateDuplicate a campaign - POST
/advanced/campaigns/{campaignId}/archiveArchive a campaign - DEL
/advanced/campaigns/{campaignId}Delete a campaign - GET
/advanced/campaign/contactsList the contacts of a campaign - POST
/advanced/campaign/contactsAdd a contact to a campaign - DEL
/advanced/campaign/contactsRemove a contact from a campaign - PATCH
/advanced/contactsSet a field on a campaign contact - GET
/advanced/campaigns/{campaignId}/manual-tasksList pending manual tasks - POST
/advanced/campaigns/{campaignId}/manual-tasks/statusComplete a manual task - GET
/advanced/campaigns/{campaignId}/progressGet per step progress - GET
/advanced/campaigns/{campaignId}/progress/contactsList the contacts of a step - GET
/advanced/campaigns/{campaignId}/exportExport campaign data as CSV - GET
/stats/advancedGet campaign statistics - POST
/advanced/attachmentsUpload message attachments - POST
/advanced/linkedin/audioUpload a LinkedIn voice note
- GET
/emails/campaign/contactsList email campaign contacts (paginated)deprecated - POST
/emails/campaign/contactsAdd a contact to an email campaigndeprecated - DEL
/emails/campaign/contactsRemove a contact from an email campaigndeprecated - POST
/emails/lists/contactsAdd a contact to an email listdeprecated - GET
/emails/campaignsList email campaignsdeprecated - POST
/emails/campaignsCreate an email campaigndeprecated - GET
/emails/campaigns/{campaignId}Get email campaign detailsdeprecated - PATCH
/emails/campaigns/{campaignId}/settings/globalUpdate email campaign schedule (global settings)deprecated - PATCH
/emails/campaigns/{campaignId}/settings/providersUpdate email campaign sending providersdeprecated - PATCH
/emails/campaigns/{campaignId}/nameRename an email campaigndeprecated - PATCH
/emails/campaigns/{campaignId}/stepsReplace email campaign stepsdeprecated - POST
/emails/campaigns/{campaignId}/startStart an email campaigndeprecated - POST
/emails/campaigns/{campaignId}/pausePause an email campaigndeprecated - PATCH
/emails/contactsSet a custom field on an email contactdeprecated - GET
/emails/campaigns/{campaignId}/activitiesGet email campaign activitiesdeprecated - POST
/emails/testSend a test emaildeprecated - GET
/statsGet email campaign statisticsdeprecated
- GET
/linkedin/campaign/contactsList LinkedIn campaign contacts (paginated)deprecated - POST
/linkedin/campaign/contactsAdd a contact to a LinkedIn campaigndeprecated - DEL
/linkedin/campaign/contactsRemove a contact from a LinkedIn campaigndeprecated - GET
/linkedin/campaignsList LinkedIn campaignsdeprecated - POST
/linkedin/campaignsCreate a LinkedIn campaigndeprecated - PATCH
/linkedin/campaigns/{campaignId}/settings/globalUpdate LinkedIn campaign schedule (global settings)deprecated - PATCH
/linkedin/campaigns/{campaignId}/nameRename a LinkedIn campaigndeprecated - PATCH
/linkedin/campaigns/{campaignId}/stepsReplace LinkedIn campaign stepsdeprecated - GET
/linkedin/campaigns/{campaignId}/activitiesGet LinkedIn campaign activitiesdeprecated - GET
/stats/linkedinGet LinkedIn campaign statisticsdeprecated
- GET
/lists/listList your lists - POST
/lists/listCreate a list - GET
/lists/list/{listId}Get a list - PATCH
/lists/list/{listId}Rename a list - DEL
/lists/list/{listId}Delete a list - POST
/lists/list/exportExport lists as CSV - GET
/lists/list/campaign-usageFind the campaigns using lists - GET
/lists/list/{listId}/rowsList or find the contacts of a list - DEL
/lists/list/{listId}/rows/{leadId}Delete a contact - POST
/lists/list/{listId}/contactsAdd a contact to a list (add or update) - POST
/lists/list/{listId}/contacts/batchAdd up to 100 contacts to a list - PATCH
/lists/contacts/{contactId}Update a contact - POST
/lists/custom-variableCreate a custom variable - GET
/lists/custom-variable/checkCheck whether a custom variable exists - GET
/lists/list/export/jobs/{jobId}Get the status of an export - GET
/lists/list/export/jobs/{jobId}/downloadDownload a finished export
- POST
/emails/blacklists/contactAdd an email or domain to the account blacklist - DEL
/emails/blacklists/contactRemove an email or domain from the account blacklist - GET
/emails/blacklistsGet the account blacklists - POST
/emails/blacklists/linkedinAdd a LinkedIn profile to the blacklist - DEL
/emails/blacklists/linkedinRemove a LinkedIn profile from the blacklist
- POST
/webhookCreate a webhook - POST
/webhook/{hookId}/testSend a test event - GET
/webhookList webhooks - DEL
/webhookDelete a webhook - EVENT
advancedCampaignActivityCampaign activity events - EVENT
campaignEndingCampaign finished - EVENT
emailCampaignActivityActivity on a legacy email campaign - EVENT
linkedinCampaignActivityActivity on a legacy LinkedIn campaign
- GET
/email-providersList email providers - POST
/email-providersConnect an SMTP/IMAP mailbox - PATCH
/email-providers/{providerId}Update an SMTP/IMAP mailbox - PATCH
/email-providers/{providerId}/sender-nameChange the sender name - DEL
/email-providers/{providerId}Delete a mailbox - GET
/domainsList tracking domains - POST
/domains/createAdd a tracking domain - POST
/domains/assignAttach a tracking domain to mailboxes - DEL
/domains/{providerId}Delete the tracking domain of a mailbox - GET
/email-providers/warmupList warmups - POST
/email-providers/warmup/enableEnable the warmup of a mailbox - POST
/email-providers/warmup/check-healthRun a deliverability diagnosis
- GET
/linkedin/accountsList LinkedIn accounts - POST
/linkedin/invitationsCreate a connection link - GET
/linkedin/invitations/{token}Get the state of a connection link - POST
/account-webhooksRegister an account webhook - GET
/account-webhooksList account webhooks - POST
/account-webhooks/testSend a test event - DEL
/account-webhooksDelete an account webhook - EVENT
linkedinAccountDisconnectedLinkedIn account disconnected
- POST
/linkedin-scrappersCreate a LinkedIn scraper (start an extraction) - GET
/linkedin-scrappersList your LinkedIn scrapers - GET
/linkedin-scrappers/{id}Get one LinkedIn scraper (poll its progress) - GET
/linkedin-scrappers/{id}/downloadDownload the contacts of a scraper (CSV) - POST
/linkedin-scrappers/{id}/enrichFind the emails of a finished scraper - POST
/linkedin-scrappers/{id}/filterRemove contacts already extracted by your other scrapers - PUT
/linkedin-scrappers/{id}/pausePause a segmented extraction - PUT
/linkedin-scrappers/{id}/resumeResume a paused, scheduled or failed scraper - POST
/linkedin-scrappers/{id}/splitDetach the part already extracted from a segmented extraction - PUT
/linkedin-scrappers/{id}/renameRename a LinkedIn scraper - DEL
/linkedin-scrappers/{id}Delete a LinkedIn scraper - POST
/linkedin-scrappers/{id}/webhookRegister a webhook on a scraper - DEL
/linkedin-scrappers/{id}/webhookRemove a webhook from a scraper - POST
/linkedin-scrappers/authesConnect a LinkedIn account for scraping (session cookies) - PUT
/linkedin-scrappers/authes/{id}Refresh the cookies of a connected scraping account
Emelia Inbox API
Served under https://api.emelia.io/inbox/api/v1, with the same API key: see Emelia Inbox API.
- GET
/emailsList emails - GET
/emails/searchSearch emails by keyword - GET
/emails/{emailId}Get the metadata of an email - PATCH
/emails/{emailId}Mark an email read or unread, starred or unstarred - DEL
/emails/{emailId}Move an email to the trash - GET
/emails/{emailId}/bodyGet the body of an email and its whole thread - POST
/emails/{emailId}/labels/{labelId}Apply a label to an email - DEL
/emails/{emailId}/labels/{labelId}Remove a label from an email - POST
/emails/bulkBulk mark read, trash, apply or remove a label - GET
/draftsList drafts - POST
/draftsCreate a draft without sending it - GET
/drafts/{draftId}Get a draft - POST
/drafts/sendSend an email now - GET
/mailboxesList connected mailboxes - GET
/signaturesList signatures - GET
/labelsList labels - POST
/labelsCreate a manual label - GET
/labels/{labelId}Get a label - PATCH
/labels/{labelId}Rename or recolor a manual label - DEL
/labels/{labelId}Delete a manual label - GET
/ai-label-rulesList AI label rules - POST
/ai-label-rulesCreate an AI label and its rule - GET
/ai-label-rules/{ruleId}Get an AI label rule - PATCH
/ai-label-rules/{ruleId}Update an AI label rule - DEL
/ai-label-rules/{ruleId}Delete an AI label rule and its label - GET
/viewsList saved views - POST
/viewsCreate a view - GET
/views/{viewId}Get a view - PATCH
/views/{viewId}Update a view - DEL
/views/{viewId}Delete a view - GET
/filtersList inbox filters - POST
/filtersCreate an inbox filter - GET
/filters/{filterId}Get an inbox filter - PATCH
/filters/{filterId}Update an inbox filter - DEL
/filters/{filterId}Delete an inbox filter - GET
/auto-forward-rulesList auto-forward rules - POST
/auto-forward-rulesCreate an auto-forward rule - GET
/auto-forward-rules/{ruleId}Get an auto-forward rule - PATCH
/auto-forward-rules/{ruleId}Update an auto-forward rule - DEL
/auto-forward-rules/{ruleId}Delete an auto-forward rule - GET
/auto-forward-rules/{ruleId}/logsList the forwarding attempts of a rule - EVENT
email.receivedAn email arrived in an inbox - EVENT
email.updatedRead or starred state changed - EVENT
email.deletedAn email was moved to the trash - EVENT
draft.sentAn email was sent directly - EVENT
label.appliedA label was applied by hand or through the API - EVENT
mailbox.sync_failedThe synchronisation of a mailbox failed