> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.kotanipay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Incoming SMS Webhook

> Webhook endpoint for AfricasTalking incoming SMS messages.

This endpoint is called directly by AfricasTalking when an inbound SMS is received on your registered shortcode. No authentication is required. KotaniPay saves the message and forwards it to all registered webhook clients for your account.

<Note>
  Configure this URL (`https://sandbox-api.kotanipay.io/api/v3/sms/incoming`) as the callback URL in your AfricasTalking dashboard under **SMS → Callback URL**.
</Note>


## OpenAPI

````yaml POST /api/v3/sms/incoming
openapi: 3.0.0
info:
  title: KOTANI PAY API PLATFORM
  description: ''
  version: '3.0'
  contact: {}
servers:
  - url: https://sandbox-api.kotanipay.io
    description: Sandbox
security: []
tags: []
paths:
  /api/v3/sms/incoming:
    post:
      tags:
        - SMS
      summary: Incoming SMS Webhook
      description: Webhook endpoint for AfricasTalking incoming SMS messages.
      operationId: SmsController_handleIncomingMessages_api/v3
      parameters: []
      responses:
        '200':
          description: Incoming message processed successfully

````