Documentation/Email Delivery/HTTP API Integration
Universal REST Adapter

HTTP API Integration

Connect any modern email provider using their REST API. High performance, Edge-compatible, and provider-agnostic.

Smart Routing Engine

Aranly features a universal adapter that understands the specific requirements of every major email vendor. Whether you use **Resend, SendGrid, Postmark, or Mailgun**, we automatically handle the headers, body format, and authentication for you.

ResendSendGridPostmarkMailgunBrevoSparkPost
1

Select Your Provider

In your Email Settings, select the HTTP API card. Use the Provider Type dropdown to pick your vendor.

  • Selecting a known provider automatically fills the API Endpoint URL.
  • If your provider isn't listed, choose Other (Generic REST) and enter your endpoint manually.
2

Add Your API Key

Enter your secret API key. We use AES-GCM encryption to secure your keys at rest. They are only ever decrypted in the secure Edge runtime to perform the send operation.


For Mailgun, enter your Private API Key. Our engine automatically handles the Basic Auth encoding.

Supported Capabilities

Our adapter provides tailored logic for these specific platforms:

Resend & SendGrid

Standard JSON structure with Bearer token authentication. Optimized for high-volume delivery.

Postmark

X-Postmark-Server-Token header support. Built for transactional speed.

Mailgun

Native multipart/form-data support. No manual encoding required.

Brevo & SparkPost

Regional API support. Respects custom domains and custom endpoints.

Pro Tip: Custom URL Proxying

Because you can edit the API EndPoint URL, you can route your traffic through an analytics proxy or a regionally-specific endpoint (like SendGrid EU) while still benefiting from Aranly's smart request builders.