Skip to main content

Arsel for developers

Arsel is a marketing engagement platform with a REST API. You can send messages across four channels, keep an audience of contacts in sync with your own database, and stream product events that trigger automations and attribute revenue.

The four channels

ChannelWhat it doesPrerequisite
EmailTransactional email and campaigns, with per-recipient delivery, open, click, bounce and complaint tracking. Send over REST or plain SMTP.A verified domain
SMSTransactional SMS and campaigns to Saudi Arabia and Egypt, with per-recipient delivery receipts.A registered sender name
WhatsAppTransactional messages from templates Meta has approved.A connected WhatsApp Business account
Push NotificationsAndroid, iOS and web notifications delivered under your own sender identity — your Firebase project, your Apple key.A client SDK or server-side device registration

Alongside the channels sit two things that make them useful:

  • Audience — contacts, lists, tags, and custom properties. Everything you send targets a contact.
  • Events & automation — send your own product events (order.completed, cart.abandoned) to trigger automations in real time and power conversion and revenue reporting.

Base URL

Every endpoint is relative to:

https://api.arsel.sa/v1

Authentication

Authenticate each request with your secret API key in the Authorization header:

Authorization: Bearer be_your_api_key_here

Generate API keys from your Arsel Dashboard. Client SDKs running inside your own app use a different, publishable pub_ key instead — see Authentication for the full comparison.

Where to go next

QuickstartSend your first email and confirm it was delivered.
AuthenticationKey formats, generation, rotation, and what belongs in client code.
API basicsErrors, pagination, rate limits, and idempotency — the conventions every endpoint shares.
GuidesChannel-by-channel integration, from domain setup to campaign sends.
API referenceEvery endpoint, grouped by resource.
Client SDKsRecord events and register devices from your web, Android, or iOS app.