> ## Documentation Index > Fetch the complete documentation index at: https://docs.kairosafrika.com/llms.txt > Use this file to discover all available pages before exploring further. # Send Quick SMS > Send a quick SMS message to a recipient # Send Quick SMS This endpoint allows you to send a quick SMS message to a single recipient. **Endpoint:** `POST /v1/external/sms/quick` ```bash cURL theme={null} curl --request POST \ --url https://api.kairosafrika.com/v1/external/sms/quick \ --header 'x-api-key: YOUR_API_KEY' \ --header 'x-api-secret: YOUR_API_SECRET' \ --header 'x-api-version: 2025-08-01' \ --header 'Content-Type: application/json' \ --data '{ "to": "233559406612", "from": "Kairos", "type": "Quick", "message": "Hello from Kairos Afrika!", "isGlobal": false }' ``` ```javascript JavaScript theme={null} const response = await fetch('https://api.kairosafrika.com/v1/external/sms/quick', { method: 'POST', headers: { 'x-api-key': 'YOUR_API_KEY', 'x-api-secret': 'YOUR_API_SECRET', 'x-api-version': '2025-08-01', 'Content-Type': 'application/json' }, body: JSON.stringify({ to: '233559406612', from: 'Kairos', type: 'Quick', message: 'Hello from Kairos Afrika!', isGlobal: false }) }); const result = await response.json(); console.log(result); ``` ```python Python theme={null} import requests response = requests.post( 'https://api.kairosafrika.com/v1/external/sms/quick', headers={ 'x-api-key': 'YOUR_API_KEY', 'x-api-secret': 'YOUR_API_SECRET', 'x-api-version': '2025-08-01', 'Content-Type': 'application/json' }, json={ 'to': '233559406612', 'from': 'Kairos', 'type': 'Quick', 'message': 'Hello from Kairos Afrika!', 'isGlobal': False } ) result = response.json() print(result) ``` ```php PHP theme={null} 'https://api.kairosafrika.com/v1/external/sms/quick', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS => json_encode(array( 'to' => '233559406612', 'from' => 'Kairos', 'type' => 'Quick', 'message' => 'Hello from Kairos Afrika!', 'isGlobal' => false )), CURLOPT_HTTPHEADER => array( 'x-api-key: YOUR_API_KEY', 'x-api-secret: YOUR_API_SECRET', 'x-api-version: 2025-08-01', 'Content-Type: application/json' ), )); $response = curl_exec($curl); curl_close($curl); echo $response; ?> ``` ## Request Body * **to** (string, required): Recipient phone number (without + prefix). * **from** (string, required): Sender ID or name. * **type** (string, required): SMS type (use "Quick" for quick SMS). * **message** (string, required): The SMS message content. * **isGlobal** (boolean, required): Whether to use global routing (true/false). ## Responses * **200 OK**: SMS sent successfully. * **400 Bad Request**: Invalid request data. ## OpenAPI ````yaml POST /v1/external/sms/quick openapi: 3.0.3 info: title: Kairos Afrika SMS API description: >- Send SMS messages through the Kairos Afrika platform. Switch between staging and production environments using the server dropdown. version: 1.0.0 contact: name: Kairos Afrika Support email: support@kairosafrika.com servers: - url: https://api.kairosafrika.com description: Sms API Base URL security: - apiKeyAuth: [] apiSecretAuth: [] paths: /v1/external/sms/quick: post: tags: - SMS summary: Send Quick SMS description: Send a quick SMS message to a single recipient operationId: sendQuickSMS parameters: - name: x-api-version in: header required: true schema: type: string enum: - '2025-08-01' description: API version header (required for full JSON response) example: '2025-08-01' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SendQuickSMSRequest' responses: '200': description: SMS sent successfully content: application/json: schema: $ref: '#/components/schemas/SMSResponse' '400': description: Bad request - Invalid input content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Unauthorized - Invalid API key content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: SendQuickSMSRequest: type: object required: - to - from - type - message - isGlobal properties: to: type: string description: Recipient phone number (without + prefix) example: '233559406612' from: type: string description: Sender ID or name example: Kairos type: type: string description: SMS type (use 'Quick' for quick SMS) example: Quick message: type: string description: The SMS message content maxLength: 1600 example: Hello from Kairos Afrika! isGlobal: type: boolean description: Whether to use global routing example: false SMSResponse: type: object properties: statusCode: type: integer description: HTTP status code example: 201 statusMessage: type: string description: Status message example: Sms successfully sent. transactionId: type: string description: Unique transaction identifier example: b0cdebad-e925-4437-b852-5aab112781f0 sequenceNo: type: string description: Sequence number example: 01K6MN2T13XNK40X17F5FH45DV data: type: object properties: totalBatches: type: integer description: Total number of batches example: 1 batches: type: array items: type: object properties: jobId: type: string description: Unique job identifier example: b7d80ca9-4839-407c-b696-74c4ab2c570e messages: type: array items: type: object properties: to: type: string description: Recipient phone number example: '233559400612' from: type: string description: Sender ID example: BLUEFS message: type: string description: SMS message content example: >- This is a testing message from the production server apis type: type: string description: SMS type example: Quick sequenceNo: type: string description: Message sequence number example: 01K6MN2T13XNK40X17F5FH45DV transactionId: type: string description: Transaction identifier example: b0cdebad-e925-4437-b852-5aab112781f0 senderAddress: type: string description: Sender address/ID example: BLUEFS timestamp: type: string format: date-time description: ISO 8601 timestamp example: '2025-10-03T09:05:08.745Z' Error: type: object required: - error - message properties: error: type: string description: Error code example: INVALID_PHONE_NUMBER message: type: string description: Human-readable error message example: The provided phone number is not valid details: type: object description: Additional error details securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: API Key for authentication apiSecretAuth: type: apiKey in: header name: x-api-secret description: API Secret for authentication ````