> For the complete documentation index, see [llms.txt](https://doc.twake.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.twake.app/developers-api/api-reference/message/post-request.md).

# POST Request

#### Before starting, make sure you added **`message_save`** into **`write privileges`**. See the [Application access and privileges](/developers-api/get-started.md#application-access-and-privileges) section.

## POST message

<mark style="color:green;">`POST`</mark> `https://api.twake.app/api/v1/messages/save`

#### Headers

| Name          | Type   | Description                               |
| ------------- | ------ | ----------------------------------------- |
| Authorization | string | `Basic base64(public_id:private_api_key)` |
| Content-Type  | string | `application/json`                        |

#### Request Body

| Name      | Type   | Description                                            |
| --------- | ------ | ------------------------------------------------------ |
| message   | object | `Require channel_id and content, see the Body section` |
| group\_id | string | `See the group_id and channel_id section`              |

{% tabs %}
{% tab title="200 If request is successful, the response should be something like this." %}

```
{
    "object": {
        "id": "--", // Message Id
        "channel_id": "--", // Channel
        "parent_message_id": "--", // Thread id
        "sender": null, // User who send the message
        "application_id": "--", // Application who send the message
        "edited": false, 
        "pinned": null,
        "hidden_data": null,
        "reactions": [],
        "modification_date": 1598518289, // Last modification date
        "creation_date": 1598518289, // Creation date
        "content": "Hello !", // Object (see Twacode) or string
    }
}
```

{% endtab %}
{% endtabs %}

### Body example:&#x20;

```
{
	"group_id": "--",
	"message": {
		"channel_id": "--",
		"content": "Hello, this is my first message !",
		"_once_ephemeral_message": false // Set true if you want this message ephemeral
	}
}
```