Connect, test and disconnect custom SMTP/IMAP sending accounts.
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/lemlist:lemlist-email-accounts-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: lemlist Email Accounts API
version: 1.0.0
description: Welcome to the lemlist Developer Documentation.
servers:
- url: https://api.lemlist.com/api
security:
- basicAuth: []
tags:
- name: Email Accounts
paths:
/user/email-accounts:
post:
summary: Connect Email Account
tags:
- Email Accounts
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- sender_name
- sender_email
- smtp_host
- smtp_port
- smtp_login
- smtp_password
- imap_host
- imap_port
- imap_login
- imap_password
properties:
sender_name:
type: string
description: Display name for the sender.
example: John Doe
sender_email:
type: string
format: email
description: Email address used as the sender.
example: john@company.com
smtp_host:
type: string
description: SMTP server hostname.
example: smtp.company.com
smtp_port:
type: integer
description: SMTP server port.
example: 587
smtp_login:
type: string
description: SMTP authentication login.
example: john@company.com
smtp_password:
type: string
description: SMTP authentication password.
example: password123
smtp_secure:
type: boolean
description: Use SSL/TLS for SMTP connection.
default: false
imap_host:
type: string
description: IMAP server hostname.
example: imap.company.com
imap_port:
type: integer
description: IMAP server port.
example: 993
imap_login:
type: string
description: IMAP authentication login.
example: john@company.com
imap_password:
type: string
description: IMAP authentication password.
example: password123
imap_secure:
type: boolean
description: Use SSL/TLS for IMAP connection.
default: false
userId:
type: string
description: Assign the email account to a specific team member. Must be a member of the team. Defaults to the API key creator or team owner.
responses:
'201':
description: Email account connected successfully
content:
application/json:
schema:
type: object
properties:
id:
type: string
description: Unique identifier of the created email account.
email:
type: string
format: email
description: The sender email address.
provider:
type: string
description: Always `custom` for SMTP/IMAP accounts.
example: custom
example:
id: umx_A1B2C3D4E5F6G7H8I9
email: john@company.com
provider: custom
'400':
description: 'Possible errors: Bad team / Missing required fields / Invalid host / This SMTP mailbox already exists'
content:
text/plain:
example: Missing required fields
'401':
description: The authentication you supplied is incorrect
content:
text/plain:
example: The authentication you supplied is incorrect
'403':
description: User is not a member of this team
content:
text/plain:
example: User is not a member of this team
'405':
description: Method not allowed
operationId: postUserEmailAccounts
x-operation-id-source: derived
/user/email-accounts/{emailAccountId}:
delete:
summary: Disconnect Email Account
tags:
- Email Accounts
parameters:
- name: emailAccountId
in: path
required: true
description: The ID of the email account to disconnect.
schema:
type: string
responses:
'200':
description: Email account disconnected successfully
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
example:
ok: true
'400':
description: Bad team
content:
text/plain:
example: Bad team
'401':
description: The authentication you supplied is incorrect
content:
text/plain:
example: The authentication you supplied is incorrect
'403':
description: You are not allowed to modify this mailbox
content:
text/plain:
example: You are not allowed to modify this mailbox
'404':
description: Email account not found
content:
text/plain:
example: Email account not found
'405':
description: Method not allowed
operationId: deleteUserEmailAccountsByEmailAccountId
x-operation-id-source: derived
/user/email-accounts/{emailAccountId}/test:
post:
summary: Test Email Account
tags:
- Email Accounts
parameters:
- name: emailAccountId
in: path
required: true
description: The ID of the email account to test.
schema:
type: string
responses:
'200':
description: Test results for SMTP and IMAP connections
content:
application/json:
schema:
type: object
properties:
smtp:
type: object
properties:
success:
type: boolean
description: Whether the SMTP connection test passed.
error:
type: string
description: Error message if the test failed.
imap:
type: object
properties:
success:
type: boolean
description: Whether the IMAP connection test passed.
error:
type: string
description: Error message if the test failed.
example:
smtp:
success: true
imap:
success: true
'400':
description: Bad team
content:
text/plain:
example: Bad team
'401':
description: The authentication you supplied is incorrect
content:
text/plain:
example: The authentication you supplied is incorrect
'404':
description: Email account not found
content:
text/plain:
example: Email account not found
'405':
description: Method not allowed
operationId: postUserEmailAccountsByEmailAccountIdTest
x-operation-id-source: derived
components:
securitySchemes:
basicAuth:
type: http
scheme: basic