eWasl Developer Docs
Build with eWasl — REST API, MCP server, and a CLI for Arabic-first social scheduling and ads.
Build with eWasl
One API to schedule and publish across every social platform, audit your ads, and drive it all from REST, an MCP server for AI agents, or the terminal. Arabic-first.
العربية: اقرأ التوثيق بالعربية — or use the EN ⇄ ع switcher in the top bar on any page.
Quick start
Mint a Bearer token in your dashboard, copy it once, and start posting in 60 seconds.
Schedule your first postPOST one JSON payload to /v1/posts/schedule — we handle delivery across Twitter, Instagram, TikTok, LinkedIn, Facebook, and YouTube.
Connect an AI agentPlug eWasl into Claude, Cursor, or ChatGPT via one-click OAuth or an API key. Tools span posts, connections, analytics, webhooks, and ads.
Use the CLInpx @ewasl/cli — publish, schedule, and manage ads from your terminal or CI, with --json output for scripting.
Core REST API
Base URL, error envelope, rate limits, idempotency.
AuthenticationGenerate, rotate, and revoke API keys. Bearer header format and scopes.
PostsPublish now or schedule across platforms, with per-platform captions.
ConnectionsList connected social accounts and token health.
WebhooksReceive post.published / post.failed events with HMAC verification.
API keysCreate, list, and revoke keys programmatically.
MCP for AI agents
What the eWasl MCP server is and the tools it exposes, mapped 1:1 to the V1 API.
Claude Desktopstdio bridge via mcp-remote — copy-paste config.
CursorNative HTTP MCP — paste the URL, generate a key.
ChatGPTCustom GPT Action setup using the OpenAPI schema.
SLA & support
- Status & uptime: https://app.ewasl.com/status
- Email: support@ewasl.com — first response in business hours.
- Issues / bugs: github.com/TahaOsa/ewasl-social-scheduler/issues
- Dashboard: app.ewasl.com