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

# Send a message to an account order

> Send a new chat message to the buyer for this account order. Order must be in processing status.



## OpenAPI

````yaml /api/openapi.json post /v2/account-orders/{accountOrder}/messages
openapi: 3.1.0
info:
  title: GameBoost
  version: 2.0.0
servers:
  - url: https://api.gameboost.com
    description: GameBoost API
security:
  - BearerTokenSecurityScheme: []
tags:
  - name: Games
    description: Games
  - name: Seller Breaks
    description: Seller Breaks
  - name: Payments
    description: Payments
  - name: Payouts
    description: Payouts
  - name: Account Offers
    description: Account Offers
  - name: Account Orders
    description: Account Orders
  - name: Item Offers
    description: Item Offers
  - name: Item Orders
    description: Item Orders
  - name: Currency Offers
    description: Currency Offers
  - name: Currency Orders
    description: Currency Orders
  - name: Webhooks
    description: Webhook events sent to your endpoints when specific actions occur
  - name: Gift Card Offers
    description: Gift Card Offers
  - name: Gift Card Orders
    description: Gift Card Orders
paths:
  /v2/account-orders/{accountOrder}/messages:
    post:
      tags:
        - Account Orders
      summary: Send a message to an account order
      description: >-
        Send a new chat message to the buyer for this account order. Order must
        be in processing status.
      parameters:
        - name: accountOrder
          in: path
          description: >-
            The ID of the account order. Can be retrieved from the list of
            account orders, or from the parent account offer, or from webhooks.
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - message
              properties:
                message:
                  description: Text content of the message to send to the buyer/seller
                  type: string
                  maxLength: 10000
                  example: >-
                    Hi! I have completed the currency delivery. Please check
                    your account and confirm receipt.
      responses:
        '200':
          description: Message sent successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Message'
        '401':
          $ref: '#/components/responses/ErrorUnauthenticated'
        '403':
          $ref: '#/components/responses/ErrorForbidden'
        '404':
          $ref: '#/components/responses/ErrorNotFound'
        '422':
          $ref: '#/components/responses/ErrorValidation'
        '429':
          $ref: '#/components/responses/ErrorRateLimited'
      security:
        - BearerToken: []
components:
  schemas:
    Message:
      description: Message object representing a chat message in an order conversation
      type: object
      properties:
        id:
          description: Unique identifier for the message
          type: string
        type:
          description: Type of message (UserMessage, SystemMessage)
          enum:
            - user_message
            - system_message
          type: string
        text:
          description: Text content of the message
          type: string
        attachment:
          description: Optional file attachment or media associated with the message
          type: object
          nullable: true
        sender:
          $ref: '#/components/schemas/MessageSender'
        sent_at:
          description: Unix timestamp when the message was sent
          type: integer
    MessageSender:
      description: Message sender information
      type: object
      properties:
        id:
          description: Unique identifier for the sender
          type: integer
        username:
          description: Censored username of the sender
          type: string
        is_admin:
          description: Whether the sender is an admin, only present for admin messages
          type: boolean
          nullable: true
  responses:
    ErrorUnauthenticated:
      description: >-
        User is not authenticated, happens when the API key is missing, expired
        or invalid
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Unauthenticated.
    ErrorForbidden:
      description: >-
        User is not authorized to perform this action, happens when you try to
        access a resource you do not have permission to access
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: This action is unauthorized.
    ErrorNotFound:
      description: Resource not found, happens when the requested resource does not exist
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Resource not found.
    ErrorValidation:
      description: Validation errors, happens when the request data is invalid
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: The given data was invalid.
              errors:
                type: object
                additionalProperties:
                  type: array
                  items:
                    type: string
                example:
                  field:
                    - Something is wrong with this field!
    ErrorRateLimited:
      description: >-
        Rate limit exceeded, happens when you exceed the rate limit for the
        endpoint
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Too many requests.
  securitySchemes:
    BearerToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````