Incoming SMS Webhook

SMS
You can set an Incoming SMS Webhook URL for each SMS service from the SMS Service Configuration page.
When a webhook URL is saved, inbound SMS messages for that service are delivered to the URL by POST using the current v2 payload.

Where to find it

Step 1: Sign in to the Atomic portal.
Step 2: Go to Services > SMS Services.
Step 3: Open the SMS service you want to update.
SMS services list with the Manage button highlighted for a selected service.
SMS services list with the Manage button highlighted for a selected service.
Step 4: Select the Incoming SMS Webhook tab.
SMS Service Configuration — Incoming SMS Webhook tab with the URL field
SMS Service Configuration — Incoming SMS Webhook tab with the URL field
Step 5: Enter the Inbound SMS Webhook URL.
Step 6: Click Update.
The tab appears after Sender ID and before Email to SMS.

Webhook URL requirements

The webhook URL is optional. If you add one, it must:
  • Start with https://
  • Include a valid host
  • Be 1024 characters or less
  • Not include embedded username or password credentials
Examples that will not be saved include http://..., javascript:..., invalid URLs, hostless URLs, and URLs longer than the allowed limit.

Clear the webhook URL

To remove the webhook URL for the service:
  1. Open the Incoming SMS Webhook tab.
  2. Clear the Inbound SMS Webhook URL field.
  3. Click Update.
Clearing the field removes the per-service webhook URL.
This setting is saved per SMS service. Updating it does not change the Service Settings tab or re-run SMS service plan/provisioning updates.