Skip to main content

SMTP Integration

Arsel provides a standard SMTP server that lets you send transactional emails using any SMTP client. This is ideal when your application already sends emails through SMTP and you want to route them through Arsel without changing your code.

When to Use SMTP vs API

SMTPREST API
Best forExisting apps with SMTP code, legacy systems, platforms that only support SMTPNew integrations, full control over request/response, programmatic workflows
AuthenticationUsername + password per connectionAPI key per request
FeaturesSend emails with HTML, text, attachmentsSend emails + list status + per-recipient tracking + SMS
Rate limitingPer-organization, same as APIPer-organization with response headers
TrackingFull delivery tracking via the API status endpointsFull delivery tracking built-in
tip

Emails sent via SMTP are processed through the same pipeline as API emails. You get the same delivery infrastructure, tracking, and analytics regardless of which method you use.

Connection Details

SettingValue
Hostsmtp.arsel.sa
Port465 (implicit TLS)
SecurityTLS required
AuthenticationPLAIN or LOGIN
Max message size25 MB

Quick Start

  1. Create SMTP credentials from your Arsel Dashboard under Settings > SMTP Credentials. See Managing Credentials.

  2. Configure your SMTP client with the connection details above and your generated username and password.

  3. Send an email through your application's existing email flow.

See Sending Emails via SMTP for detailed setup examples across languages and frameworks.

Requirements

Before sending via SMTP, ensure:

  • Your sender domain is verified in the Arsel dashboard
  • Your SMTP credentials are active (not revoked)
  • Your organization's sending quota has not been exceeded
  • Your organization is not suspended due to bounce/complaint rates