Sign in

v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
Posts

Create Post

Creates a post in the chat specified in path. Any mention can be added within the text attribute of the request body in .md format - ![:Type](id), where type is one of (Person, Team, File, Note, Task, Event, Link, Card) and id is a unique identifier of the mentioned object of the specified type. Attachments of the following types (File, Card, Event, Note) can also be added to a post by passing type and ID of attachment(s) in request body.

post/team-messaging/v1/chats/{chatId}/posts

Path parameters

chatIdstring required

Internal identifier of a chat.

Request body

textstring

Text of a post. Maximum length is 10000 symbols. Mentions can be added in .md format ![:Type](id)

Response

Success

idstring

Internal identifier of a post

groupIdstring

Internal identifier of a group a post belongs to

type'TextMessage' | 'PersonJoined' | 'PersonsAdded'

Type of post

textstring

For 'TextMessage' post type only. Text of a message

creatorIdstring

Internal identifier of a user - author of a post

addedPersonIdsstring[]

For 'PersonsAdded' post type only. Identifiers of persons added to a group

creationTimestring date-time

Post creation datetime in ISO 8601 format

lastModifiedTimestring date-time

Post last modification datetime in ISO 8601 format

activitystring

Label of activity type

titlestring

Title of a message. (Can be set for bot's messages only)

iconUristring uri

Link to an image used as an icon for this message

iconEmojistring

Emoji used as an icon for this message

Example response

{
  "attachments": [
    {
      "footnote": {
        "time": "2016-03-10T18:07:52.534Z"
      }
    }
  ]
}