# Send Message

URL: https://developers.cuedesk.com/reference/messages-api/send-message

`POST https://api.cuedesk.com/v1/messages`

Guide: [Messages API](https://developers.cuedesk.com/api/messages_api.md)

Authentication: send `Authorization: Bearer <token>`, with an API token from Settings > API Tokens.

The OpenAPI operation. `$ref` values point into https://developers.cuedesk.com/openapi.json.

```json
{
  "tags": [
    "Messages API"
  ],
  "summary": "Send Message",
  "operationId": "send_message_v1_messages_post",
  "parameters": [
    {
      "name": "Authorization",
      "in": "header",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Authorization"
      },
      "description": "An API token from **Settings > API Tokens**, as `Bearer <token>`.",
      "example": "Bearer <token>"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/MessageRequest"
        }
      }
    }
  },
  "responses": {
    "202": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/MessageResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-cue-guide": {
    "title": "Messages API",
    "url": "/api/messages_api"
  }
}
```