--- title: "Send Your First Message in 5 Minutes" slug: "send-your-first-message-in-5-minutes" updated: 2026-10-05T19:49:10Z published: 2026-10-05T19:49:10Z canonical: "developer.rocket.chat/send-your-first-message-in-5-minutes" --- > ## Documentation Index > Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt > Use this file to discover all available pages before exploring further. # Send Your First Message in 5 Minutes In this quickstart, you send a message to a channel with the Rocket.Chat REST API. All you need is a terminal with `curl` and a Rocket.Chat account. ## Prerequisites - A Rocket.Chat workspace you can sign in to, and its URL (for example, `https://chat.example.com`). If you don't have one, set up a test workspace as described in [Environment](/apidocs/environment). - Your API credentials for that workspace — an auth token and user ID. - A channel you can post to, such as `#general`. ## Step 1: Get your auth tokens Obtain your `authToken` and `userId` as described in [Authenticate a REST Client](/apidocs/authenticate-a-rest-client) — log in with your username and password, or use a personal access token. You pass these two values as headers in the next step. ## Step 2: Post the message Call the [Post Message](/apidocs/post-message) endpoint, passing your tokens as headers and the target channel and message text in the body: ```bash curl -X POST https:///api/v1/chat.postMessage \     -H "X-Auth-Token: your-auth-token" \     -H "X-User-Id: your-user-id" \     -H "Content-Type: application/json" \     -d '{ "channel": "#general", "text": "Sample message" }' ``` ## Expected result A successful call returns the message that was created: ```json {  "ts": 1481748965123,  "channel": "general",  "message": {    "alias": "",    "msg": "This is a test!",    "parseUrls": true,    "groupable": false,    "ts": "2016-12-14T20:56:05.117Z",    "u": {      "_id": "y65tAmHs93aDChMWu",      "username": "graywolf336"    },    "rid": "GENERAL",    "_updatedAt": "2016-12-14T20:56:05.119Z",    "_id": "jC9chsFddTvsbFQG7"  },  "success": true } ``` Open the channel in your workspace — your message appears immediately. ## Next steps - Add an alias, avatar, emoji, or rich attachments to your message - the [Post Message](/apidocs/post-message) reference documents every field. - Explore the other messaging endpoints in the [Messaging API](/apidocs/introduction-to-messaging) section. - Extend your workspace from the inside: [Build Your First Apps-Engine App](/apidocs/build-your-first-apps-engine-app). - Prefer a step-by-step walkthrough in a test workspace? Start from [Step 1: Register Yourself as a User](/apidocs/step-1-register-yourself-as-a-user).