> ## 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.

# Register SMS Webhook

> Register a webhook client to receive SMS notifications

Register a webhook URL to receive real-time notifications for incoming SMS messages and delivery reports. Only one webhook can be registered per integrator account. Returns a `409` if a webhook is already registered — use the update endpoint to change it.


## OpenAPI

````yaml POST /api/v3/sms/clients
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/clients:
    post:
      tags:
        - SMS
      summary: Register SMS Webhook
      description: Register a webhook client to receive SMS notifications
      operationId: SmsController_registerWebhook_api/v3
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterSmsClientDto'
      responses:
        '201':
          description: ''
components:
  schemas:
    RegisterSmsClientDto:
      type: object
      properties:
        webhookUrl:
          type: string
          description: Webhook URL to receive SMS notifications
          example: https://myapp.com/webhooks/sms
      required:
        - webhookUrl

````