Shortcode Inbox SMS Webhook

Use a shortcode inbox webhook when you want inbound messages sent to your Bulkit shortcode delivered directly to your application.

Endpoints

Bulkit sends inbound shortcode payloads to your configured webhook URL.

Authorization

Bulkit does not require you to return API credentials in the webhook response. Secure the receiving endpoint with HTTPS and your own verification checks.

Typical flow

1. A mobile subscriber sends an SMS to your shortcode.
2. Bulkit receives the inbound message.
3. Bulkit forwards the message payload to your webhook URL.
4. Your application stores or processes the inbound message.

Example webhook payload

{
  "event": "sms.inbound",
  "mobile": "254700000001",
  "shortcode": "BULK_IT",
  "message": "Hello",
  "received_at": "2026-03-09T15:00:00+03:00"
}

Expected webhook response

Your endpoint should return a 200 OK as soon as the payload is accepted.

{
  "status": "received"
}

Notes

• use a stable public HTTPS URL
• keep webhook handlers idempotent
• store the raw payload for troubleshooting and replay

Error response

Return a 2xx response after you accept the inbound message. Non-2xx responses should be treated as webhook handling failures.