REST API
Use the eCall REST API to send SMS, Whatsapp and RCS messages over HTTPS, track delivery status, upload media, and receive webhook events.
Last updated
Was this helpful?
⌘Ctrlk
Use the eCall REST API to send SMS, Whatsapp and RCS messages over HTTPS, track delivery status, upload media, and receive webhook events.
Use the eCall REST API to build SMS, Whatsapp and RCS messaging into your app.
Send messages over JSON and HTTPS.
Track delivery status.
Receive webhook events and inbound SMS.
Base URL: https://rest.ecall.ch
API style: REST over JSON and HTTPS
Authentication: HTTP Basic Authentication
Supports: SMS messaging, RCS messaging, status queries, media upload, and webhooks
Enable the REST interface in the eCall portal under Interfaces → Overview before you start.
Send SMS, Whatsapp and RCS messages.
Send to one recipient or many recipients in one request.
Query delivery status for up to seven days.
Receive webhook events for status changes and inbound SMS and Whatsapp.
Upload media for rich RCS and Whatsapp messages.
You need an SMS API for a backend, integration, or automation workflow.
You need an RCS API with rich content and uploaded media.
You want webhook-based delivery tracking and inbound SMS handling.
The eCall REST API supports SMS messaging, Whatsapp messaging, RCS messaging, delivery status queries, media upload, and webhook-based event handling.
Use it for single-message sends, batch sends, and inbound SMS forwarding.
The API is provided by F24 Schweiz AG.
Use this base URL:
The connection uses TLS 1.2 or TLS 1.3.
Plain HTTP is not supported.
Send every request with an Authorization header.
Use HTTP Basic Authentication.
Use either of these credential types:
Your eCall account credentials
A dedicated API sub-user from Interfaces → Overview
Two API versions are available.
Target a version in the URL path or request header.
If you omit the version, the default is v1.
This default can change in later updates.
v1 (default)
2023-02-02
–
v2
2023-12-12
GET /api/message/{messageId} and POST /api/message return timestamps in UTC using ISO 8601 with Z.
Accepted header values:
1 or 1.0 for v1
2 or 2.0 for v2
JSON field names are case-insensitive.
Enum values are case-sensitive.
Send all text as UTF-8.
Account settings are cached. Changes can apply with a delay.
Every response includes the x-f24-request-id header.
Include x-f24-request-id in support requests.
Set notification.addresses in a send request to receive status updates.
eCall sends these notifications to your endpoint.
Allow inbound traffic from these source IPs:
193.93.208.200
193.93.208.149
193.93.208.153
Your endpoint must return HTTP 200 OK.
Incoming SMS on a rented eCall number can be forwarded.
eCall sends the message to your HTTP or HTTPS endpoint with POST.
Configure the target URL in the portal for the SMS number.
The request schema is documented under ReceivedMessage.
The inbound endpoint is POST /api/webhooks/receivedmessage.
Last updated
Was this helpful?
Was this helpful?
https://rest.ecall.chAuthorization: Basic <base64(username:password)>https://rest.ecall.ch/api/v2/messageX-API-Version: 2