> ## Documentation Index > Fetch the complete documentation index at: https://www.quo.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Send a text message > Send a text message from your Quo number to a recipient. ## OpenAPI ````yaml https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/messages openapi: 3.1.0 info: title: Quo Public API version: 1.0.0 description: API for connecting with Quo. contact: name: Quo Support email: support@quo.com url: https://support.quo.com/ termsOfService: https://www.quo.com/terms servers: - description: Production server url: https://api.quo.com security: - apiKey: [] tags: - description: Operations related to calls name: Calls - description: >- Operations related to call summaries, including AI-generated summaries and Sona voice assistant summaries name: Call Summaries - description: >- Operations related to call transcripts, including AI-generated transcripts and Sona voice assistant transcripts name: Call Transcripts - description: Operations related to contacts name: Contacts - description: Operations related to conversations name: Conversations - description: Operations related to text messages name: Messages - description: Operations related to phone numbers name: Phone Numbers - description: Operations related to users name: Users - description: Operations related to webhooks name: Webhooks paths: /v1/messages: post: tags: - Messages summary: Send a text message description: Send a text message from your Quo number to a recipient. operationId: sendMessage_v1 parameters: [] requestBody: required: true content: application/json: schema: type: object required: - content - from - to properties: content: minLength: 1 maxLength: 1600 pattern: .*\S.* description: The text content of the message to be sent. type: string phoneNumberId: description: >- DEPRECATED, use "from" instead. Quo phone number ID to send a message from examples: - OP1232abc deprecated: true pattern: ^PN(.*)$ type: string example: OP1232abc from: description: >- The sender's phone number. Can be either your Quo phone number ID or the full phone number in E.164 format. examples: - '+15555555555' example: '+15555555555' anyOf: - pattern: ^PN(.*)$ type: string - description: >- A phone number in E.164 format, including the country code. examples: - '+15555555555' pattern: ^\+[1-9]\d{1,14}$ type: string example: '+15555555555' to: minItems: 1 maxItems: 10 type: array items: anyOf: - description: >- A phone number in E.164 format, including the country code. examples: - '+15555555555' pattern: ^\+[1-9]\d{1,14}$ type: string example: '+15555555555' - maxLength: 15 type: string userId: description: >- The unique identifier of the Quo user sending the message. If not provided, defaults to the phone number owner. examples: - US123abc pattern: ^US(.*)$ type: string example: US123abc setInboxStatus: type: string enum: - done description: >- Used to set the status of the related Quo inbox conversation. The default behavior without setting this parameter will be for the message sent to show up as an open conversation in the user's inbox. Setting the parameter to `'done'` would move the conversation to the Done inbox view. examples: - done example: done responses: '202': description: Success content: application/json: schema: type: object required: - data properties: data: type: object required: - id - to - from - text - phoneNumberId - conversationId - direction - userId - status - createdAt - updatedAt properties: id: description: The unique identifier of the message. examples: - AC123abc pattern: ^AC(.*)$ type: string example: AC123abc to: type: array items: description: >- A phone number in E.164 format, including the country code. examples: - '+15555555555' pattern: ^\+[1-9]\d{1,14}$ type: string example: '+15555555555' from: description: >- The from identifier, typically a E.164 phone number but can be a variety of formats. examples: - '+15555555555' type: string example: '+15555555555' text: description: The content of the message. examples: - Hello, world! type: string example: Hello, world! phoneNumberId: anyOf: - description: >- The unique identifier of the Quo phone number that the message was sent from. examples: - PN123abc pattern: ^PN(.*)$ type: string example: PN123abc - type: 'null' conversationId: description: The unique identifier of the conversation. examples: - CN123abc pattern: ^CN(.*)$ type: string example: CN123abc direction: type: string enum: - incoming - outgoing description: >- The direction of the message relative to the Quo number. examples: - incoming example: incoming userId: description: >- The unique identifier of the user who sent the message. Null for incoming messages. examples: - US123abc pattern: ^US(.*)$ type: string example: US123abc status: type: string enum: - queued - sent - delivered - undelivered - received description: The status of the message. examples: - sent example: sent createdAt: description: >- The timestamp when the message was created at, in ISO 8601 format examples: - '2022-01-01T00:00:00Z' format: date-time type: string example: '2022-01-01T00:00:00Z' updatedAt: description: >- The timestamp when the message status was last updated, in ISO 8601 format. examples: - '2022-01-01T00:00:00Z' format: date-time type: string example: '2022-01-01T00:00:00Z' '400': description: A2P Registration Not Approved content: application/json: schema: type: object required: - message - code - status - docs - title - description properties: message: type: string code: const: '0206400' type: string status: const: 400 type: number docs: const: https://quo.com/docs type: string title: const: A2P Registration Not Approved type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string description: const: A2P Registration Not Approved type: string '401': description: Unauthorized content: application/json: schema: type: object required: - message - code - status - docs - title properties: message: type: string code: const: '0200401' type: string status: const: 401 type: number docs: const: https://quo.com/docs type: string title: const: Unauthorized type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string '402': description: Subscription Expired content: application/json: schema: type: object required: - message - code - status - docs - title - description properties: message: type: string code: const: '0201402' type: string status: const: 402 type: number docs: const: https://quo.com/docs type: string title: const: Subscription Expired type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string description: const: Your subscription has expired type: string '403': description: Not Phone Number User content: application/json: schema: type: object required: - message - code - status - docs - title - description properties: message: type: string code: const: '0202403' type: string status: const: 403 type: number docs: const: https://quo.com/docs type: string title: const: Not Phone Number User type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string description: const: Not Phone Number User type: string '404': description: Not Found content: application/json: schema: type: object required: - message - code - status - docs - title properties: message: type: string code: const: '0200404' type: string status: const: 404 type: number docs: const: https://quo.com/docs type: string title: const: Not Found type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string '500': description: Unknown Error content: application/json: schema: type: object required: - message - code - status - docs - title properties: message: type: string code: const: '0201500' type: string status: const: 500 type: number docs: const: https://quo.com/docs type: string title: const: Unknown type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string security: - apiKey: [] components: securitySchemes: apiKey: in: header name: Authorization type: apiKey ````