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

# Send a Message

> Sends a plain-text message to a specific chat room via the Upwork messaging API. Requires an authorized freelancer who is a participant in the room. The workspace must have an active Master Inbox addon subscription, trial, or feature flag.



## OpenAPI

````yaml POST /v1/master-inbox/rooms/{roomId}/stories
openapi: 3.1.0
info:
  title: Getmany Service API
  description: This is the reference documentation and schemas for the Getmany Service API.
  version: 1.0.0
servers:
  - url: https://api.getmany.io/service
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Agency
    description: >-
      Agency information tied to the workspace, including agency profile
      details, seat-holders in an agency, and aggregated proposal performance
      stats
  - name: Job Searches
    description: Saved search configurations that scan the Upwork market
  - name: Jobs Feed
    description: >-
      Endpoints related to retrieving the jobs list matching with a job search
      configuration
  - name: Bid Intents
    description: List and manage bidding intents
  - name: Miscellaneous
    description: Various general purpose endpoints
  - name: Master Inbox
    description: Chat room management and messaging endpoints
paths:
  /v1/master-inbox/rooms/{roomId}/stories:
    post:
      tags:
        - Master Inbox
      summary: Send a message to a chat room
      description: >-
        Sends a plain-text message to a specific chat room via the Upwork
        messaging API. Requires an authorized freelancer who is a participant in
        the room. The workspace must have an active Master Inbox addon
        subscription, trial, or feature flag.
      operationId: postV1Master-inboxRoomsByRoomIdStories
      parameters:
        - name: roomId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                message:
                  type: string
                  description: Plain text message to send.
                  example: Hi, I'd like to discuss the project details.
                freelancerUid:
                  type: string
                  description: >-
                    UID of the freelancer whose OAuth credentials will be used
                    to send the message.
                  example: '1621293360163461120'
              required:
                - message
                - freelancerUid
      responses:
        '200':
          description: Message sent successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      storyId:
                        type: string
                        description: Upwork story ID.
                      userId:
                        type:
                          - string
                          - 'null'
                        description: Upwork user ID of the sender.
                      userName:
                        type: string
                        description: Display name of the sender.
                      userPhotoUrl:
                        type: string
                        description: Avatar URL of the sender.
                      message:
                        type: string
                        description: Message text content.
                      createdAt:
                        type: string
                        format: date-time
                        description: When the message was sent (ISO-8601).
                    required:
                      - storyId
                      - userId
                      - userName
                      - userPhotoUrl
                      - message
                      - createdAt
                required:
                  - data
        '400':
          description: Invalid input
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: number
                  detail:
                    type: string
                  instance:
                    type: string
                    format: uri
                required:
                  - type
                  - title
                  - status
                  - detail
                  - instance
        '403':
          description: Access denied — addon required or freelancer not authorized
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: number
                  detail:
                    type: string
                  instance:
                    type: string
                    format: uri
                required:
                  - type
                  - title
                  - status
                  - detail
                  - instance
        '404':
          description: Room or freelancer not found
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: number
                  detail:
                    type: string
                  instance:
                    type: string
                    format: uri
                required:
                  - type
                  - title
                  - status
                  - detail
                  - instance
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````