Skip to Content
SMS APIHow to Setup SMS WebhookKeyword Inbox SMS Webhook

Keyword Inbox SMS Webhook

We use HTTP callback (webhook) to forward incoming inbox messages directly to your application. If you do not have any SMS Keyword, click here  to learn more.

Click organizations (business account) from the navigation menu

Click business account from the navigation menu

Click an organization/account assigned to keyword of interest.

Click an account assigned to keyword of interest

Click on the keywords tab.

Name the API Key appropriately

Click on the edit button.

Click on the edit button

Provide your forwarding url and submit.

Provide your forwarding url and submit

Example JSON payload

{ "id": 121, "api_date": "2021-04-10T15:04:00Z", "insert_date": "2021-04-10T15:05:00Z", "message": "Sample Keyword", "sender": "+254700000002", "short_code": "110011", "retries": 0 }
id Unique id for the inbox message.
api_date Time the message reached SMSLeopard (RFC 3339).
insert_date Time the message was saved (RFC 3339). May include fractional seconds and a UTC offset.
message Received message.
sender Sender phone number.
short_code Shortcode that received the message.
retries Number of retries at forwarding the inbox message.