Create Channel Message

Request

Path Params

channelId

string

required

Header Params

Authorization

string

required

Default:

Bot {token}

Content-Type

string

required

Default:

application/json

Body Params application/json

content

string | null

required

The main text content of the message. Maximum of 2000 characters.

<= 2000 characters

embeds

array[object (Message Embed) {8}]

required

An array of embedded media or content objects that can be attached to the message. Maximum of 5 items.

<= 5 items

title

string | null

required

Title of the embed

<= 16 characters

description

string | null

required

Description text for the embed (Markdown supported)

<= 1024 characters

url

string <uri> | null

optional

URL associated with the embed

color

number | null

required

Color code for the embed, represented in hexadecimal format

author

object | null

required

Contains information about the author of the embed

thumbnail

object | null

required

Contains information about the thumbnail image

image

object | null

required

Contains information about the image

footer

object | null

required

Contains information about the footer

attachments

array [object {3}]

required

An array of files that can be attached to the message.

url

string

required

The URL of the attached file.

name

string

required

The name of the attached file.

fileSizeBytes

number

required

The size of the attached file in bytes.

replyTo

string

optional

The ID of the message being replied to.

Example

{
  "content": "string",
  "embeds": [
    {
      "title": "string",
      "description": "string",
      "url": "http://example.com",
      "color": 0,
      "author": {
        "name": "string",
        "icon_url": "http://example.com"
      },
      "thumbnail": {
        "url": "http://example.com"
      },
      "image": {
        "url": "http://example.com"
      },
      "footer": {
        "text": "string",
        "icon_url": "http://example.com"
      }
    }
  ],
  "attachments": [
    {
      "url": "string",
      "name": "string",
      "fileSizeBytes": 0
    }
  ],
  "replyTo": "string"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

success

boolean

required

message

object (Message)

required

string

required

Unique identifier for the message

channelId

string

required

ID of the channel where the message was posted

type

string

required

Type of the message (e.g., 'text' for a text message)

content

string | null

required

Content of the message (Markdown supported)

<= 2000 characters

attachments

array [object] | null

optional

Attachments for the message (may be empty)

<= 5 items

createdBy

object (User)

required

User who created the message

editedAt

string <date-time>

optional

Timestamp of when the message was last edited

replyTo

string

optional

ID of the message being replied to, or null if the message is not a reply

embeds

array[object (Message Embed) {8}]

required

List of embeds included with the message

<= 5 items

emojis

array [object {1}]

optional

reactions

array [object {3}]

optional

nonce

string

optional

Unique identifier for this message instance, used to prevent duplicates

createdAt

string <date-time>

required

Timestamp of when the message was created

mentions

object

required

Information about users mentioned in the message

Example

{
  "success": true,
  "message": {
    "id": "string",
    "channelId": "string",
    "type": "string",
    "content": "string",
    "attachments": [
      {}
    ],
    "createdBy": {
      "id": "string",
      "username": "string",
      "subdomain": "string",
      "profilePicture": null,
      "banner": null,
      "bot": false,
      "presence": 0,
      "badges": [],
      "userStatus": {
        "content": null,
        "emojiId": null
      },
      "userRPC": {
        "type": null,
        "name": null,
        "id": null,
        "startedAt": null
      },
      "connections": [],
      "createdAt": "CURRENT_TIMESTAMP",
      "lastOnline": "CURRENT_TIMESTAMP",
      "system": false
    },
    "editedAt": "2019-08-24T14:15:22Z",
    "replyTo": "string",
    "embeds": [
      {
        "title": "string",
        "description": "string",
        "url": "http://example.com",
        "color": 0,
        "author": {
          "name": "string",
          "icon_url": "http://example.com"
        },
        "thumbnail": {
          "url": "http://example.com"
        },
        "image": {
          "url": "http://example.com"
        },
        "footer": {
          "text": "string",
          "icon_url": "http://example.com"
        }
      }
    ],
    "emojis": [
      {
        "emojiId": "string"
      }
    ],
    "reactions": [
      {
        "emojiId": "string",
        "count": 0,
        "users": [
          {
            "userId": "string",
            "timestamp": "2019-08-24T14:15:22Z"
          }
        ]
      }
    ],
    "nonce": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "mentions": {
      "users": [
        "string"
      ]
    }
  }
}