> ## Documentation Index > Fetch the complete documentation index at: https://voyant.travel/docs/llms.txt > Use this file to discover all available pages before exploring further. # Send an SMS message > Sends an SMS message. Requires scope: sms:send ## OpenAPI ````yaml /api-specs/services.json post /sms/v1/messages openapi: 3.1.0 info: title: Voyant Cloud REST API version: 1.0.0 description: >- Public REST API for Voyant Cloud products: Vault, SMS, Email, Verification, Video, Realtime, and Browser. All requests authenticate with an API token passed as an HTTP bearer token in the Authorization header. Each operation requires a specific token scope, documented in the operation description. servers: - url: https://api.voyant.travel description: Production security: - bearerAuth: [] tags: - name: Vault description: >- Encrypted secret storage and envelope/per-call cryptography scoped to an organization vault. - name: SMS description: Send SMS messages and inspect message history and phone numbers. - name: Email description: Send transactional email and inspect message history. - name: Verification description: >- Start and check one-time-code verifications across SMS, call, email, and WhatsApp. - name: Video description: >- Upload, manage, caption, and watermark videos, and mint signed playback tokens. - name: Realtime description: >- Publish messages to realtime channels, inspect history and presence, and mint short-lived subscriber tokens. - name: Browser description: >- Headless browser rendering, scraping, structured extraction, crawling, and interactive sessions. paths: /sms/v1/messages: post: tags: - SMS summary: Send an SMS message description: 'Sends an SMS message. Requires scope: sms:send' operationId: sendSmsMessage requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SendSmsInput' responses: '201': description: Message queued content: application/json: schema: type: object required: - data properties: data: $ref: '#/components/schemas/SmsMessageSummary' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' '503': $ref: '#/components/responses/ServiceUnavailable' x-codeSamples: - lang: typescript label: SDK source: >- import { createVoyantCloudClient } from "@voyant-travel/cloud-sdk"; const cloud = createVoyantCloudClient({ apiKey: process.env.VOYANT_API_KEY }); const message = await cloud.sms.sendMessage({ "to": "+14155551234", "body": "Your code is 123456", "from": "" }); - lang: bash label: cURL source: |- curl --request POST \ --url https://api.voyant.travel/sms/v1/messages \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "to": "+14155551234", "body": "Your code is 123456", "from": "" }' - lang: javascript label: Node source: >- const response = await fetch("https://api.voyant.travel/sms/v1/messages", { method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer " }, body: JSON.stringify({ "to": "+14155551234", "body": "Your code is 123456", "from": "" }), }); const data = await response.json(); - lang: python label: Python source: |- import requests response = requests.post( "https://api.voyant.travel/sms/v1/messages", headers={ "Authorization": "Bearer " }, json={ "to": "+14155551234", "body": "Your code is 123456", "from": "" } ) data = response.json() components: schemas: SendSmsInput: type: object required: - to - body properties: to: type: string pattern: ^\+[1-9]\d{1,14}$ description: E.164 recipient. example: '+14155551234' body: type: string minLength: 1 maxLength: 1600 example: Your code is 123456 from: type: - string - 'null' maxLength: 20 description: Optional sender number or alphanumeric sender id. SmsMessageSummary: type: object required: - id - organizationId - toNumber - fromNumber - body - status - segments - createdAt - updatedAt properties: id: type: string organizationId: type: string toNumber: type: string fromNumber: type: string body: type: string status: type: string enum: - queued - sent - delivered - undelivered - failed segments: type: integer priceCents: type: - integer - 'null' providerMessageSid: type: - string - 'null' providerStatus: type: - string - 'null' errorCode: type: - string - 'null' errorMessage: type: - string - 'null' sentAt: type: - string - 'null' format: date-time deliveredAt: type: - string - 'null' format: date-time lastEventAt: type: - string - 'null' format: date-time createdAt: type: string format: date-time updatedAt: type: string format: date-time Error: type: object properties: error: type: string RateLimitError: type: object required: - error properties: error: type: string retryAfterMs: type: integer description: Milliseconds to wait before retrying. responses: BadRequest: description: Invalid request content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: Authentication is missing, invalid, revoked, or expired. content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: The API token does not include a scope required for this operation. content: application/json: schema: $ref: '#/components/schemas/Error' TooManyRequests: description: Rate limit exceeded. content: application/json: schema: $ref: '#/components/schemas/RateLimitError' ServerError: description: An unexpected error occurred. content: application/json: schema: $ref: '#/components/schemas/Error' ServiceUnavailable: description: >- A required dependency (for example the platform database) is not available. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer description: >- Voyant Cloud API token, passed as `Authorization: Bearer `. Each token carries a fixed set of scopes; an operation rejects tokens missing its required scope. ````