> ## Documentation Index
> Fetch the complete documentation index at: https://platform.tatango.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Message to Entire List

> This endpoint sends a message.

## Request URL

```http theme={null}
POST https://app.tatango.com/api/v2/lists/{ID}/messages
```


## OpenAPI

````yaml POST /api/v2/lists/{ID}/messages
openapi: 3.1.0
info:
  title: Tatango Legacy v2 API
  description: Tatango legacy v2 API endpoints for existing integrations.
  version: 2.0.0
servers:
  - url: https://app.tatango.com
security:
  - basicAuth: []
paths:
  /api/v2/lists/{ID}/messages:
    post:
      tags:
        - Messaging
      summary: Send Message to Entire List
      description: This endpoint sends a message.
      parameters:
        - name: ID
          in: path
          description: ID of the list
          required: true
          schema:
            type: integer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                message:
                  type: object
                  properties:
                    content:
                      type: string
                      description: Message content
                  required:
                    - content
              required:
                - message
            example:
              message:
                content: Your message content here
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: OK
                  message:
                    type: object
                    properties:
                      id:
                        type: integer
                        example: 4
              example:
                status: OK
                message:
                  id: 4
      x-codeSamples:
        - lang: Ruby
          label: Ruby
          source: >-
            require 'net/http'

            require 'uri'

            require 'json'


            uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/messages')

            http = Net::HTTP.new(uri.host, uri.port)

            http.use_ssl = true

            request = Net::HTTP::Post.new(uri.request_uri)

            request.basic_auth("emailaddress@mydomain.com", "my_api_key")

            request['Accept'] = 'application/json'

            request['Content-Type'] = 'application/json'

            request.body = {"message" => {"content" => "Hello from Tatango!",
            "send_at" => "2023-12-01T10:00:00Z"}}.to_json

            response = http.request(request)
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Tatango authenticates API requests by validating an API key passed via
        HTTP Basic Authentication. Use your login email as the username and your
        API key as the password.

````