Mailboxes

Connect a mailbox from any provider

Connects one mailbox from any email provider with its server settings. Argorant first signs in to send and to read replies and connects the mailbox only when both work; otherwise the answer is sign_in_failed with the test result. The password is stored encrypted and never returned. Connecting the same address again replaces its settings, which is how a mailbox is reconnected after a password change. A free trial connects up to 2 mailboxes. Up to 30 connects an hour; use the bulk route for more.

CostWhat it doesKey scopes
FreeWritesargorant:manage_lists
post/api/v1/inboxes/smtp

Request

  • Base URL: https://app.argorant.com
  • URL: https://app.argorant.com/api/v1/inboxes/smtp
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Any unique text up to 128 characters. A retry with the same key and the same body within 24 hours returns the first answer (with the header Idempotent-Replayed: true) instead of doing the work twice. The same key with another body answers 409 idempotency_conflict.

X-Request-Idstring

Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.

Request body

emailstring email required

The mailbox address that sends.

display_namestring

The sender name people see.

preset'zoho' | 'zoho_eu' | 'zoho_personal' | 'fastmail' | 'godaddy' | 'titan' | 'hostinger' | 'ionos' | 'ionos_de' | 'ionos_uk' | 'namecheap' | 'yahoo' | 'icloud' | 'outlook' | 'other'

An email provider from the presets. Fills every empty server name, port and security setting.

smtp_hoststring

Server for sending. Needed without a preset.

smtp_portinteger

Port for sending. Use 587. If you send 465, Argorant tries 587 with starttls and saves 587 when it works. Needed without a preset.

smtp_secure'ssl' | 'starttls' | 'none'

Security for sending, starttls on port 587. Leave out to pick it from the port.

smtp_usernamestring

Sign-in name for sending. Leave out when it is the email address.

smtp_passwordstring password required

The password, or an app password when the provider asks for one. Stored encrypted, never returned.

imap_hoststring

Server for reading replies. Needed without a preset.

imap_portinteger

Port for reading replies.

imap_secure'ssl' | 'starttls' | 'none'

Security for reading replies. Leave out to use ssl on port 993 and starttls on port 143.

imap_usernamestring

Sign-in name for reading replies. Leave out to use the one for sending.

imap_passwordstring password

Password for reading replies. Leave out to use the one for sending.

daily_limitinteger

Cold emails a day from this mailbox.

Example request

{
  "email": "elena@northgate-advisory.com",
  "display_name": "Elena Vaughn",
  "preset": "zoho",
  "smtp_host": "smtppro.zoho.com",
  "smtp_port": 587,
  "imap_host": "imappro.zoho.com"
}

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.