# How to create new channel via api?

**URL:** <https://forum.mattermost.com/t/how-to-create-new-channel-via-api/6171>\
**Category:** Troubleshooting\
**Created:** [November 16, 2018, 6:49am UTC](https://forum.mattermost.com/t/how-to-create-new-channel-via-api/6171 "2018-11-16T06:49:27Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![tanya](https://avatars.discourse-cdn.com/v4/letter/t/35a633/32.png) [@tanya](https://forum.mattermost.com/u/tanya)\
**Post date:** [November 16, 2018, 6:49am UTC](https://forum.mattermost.com/t/how-to-create-new-channel-via-api/6171/1 "2018-11-16T06:49:27Z")

</div>

Create private channel with API request

mattermost 5.5

macbook$ curl --request POST --url ‘[http://localhost:8065/api/v4/channels](http://localhost:8065/api/v4/channels)’ --header ‘Authorization: Bemdq7b1h’ --header ‘Content-Type: application/json’ --data ‘{“display\_name”:“testviaCurl”,“name”:“testviacurl”,“team\_id”:“3”,“purpose”:"",“type”:“P”  
}’

Response:  
{“id”:“store.sql\_channel.get\_channels.not\_found.app\_error”,“message”:“No channels were found”,“detailed\_error”:"",“request\_id”:“ixcbx9fegsas8r8dpfwa”,“status\_code”:404}  
Any help appreciated.

---

<div class="post-metadata">

**Author:** ![amy.blais](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/amy.blais/32/7481_2.png) [@amy.blais](https://forum.mattermost.com/u/amy.blais)\
**Post date:** [November 16, 2018, 2:03pm UTC](https://forum.mattermost.com/t/how-to-create-new-channel-via-api/6171/2 "2018-11-16T14:03:36Z")

</div>

Hi @tanya,

This documentation might help: [https://api.mattermost.com/#tag/channels%2Fpaths%2F~1channels%2Fpost](https://api.mattermost.com/#tag/channels%2Fpaths%2F~1channels%2Fpost). Let me know any questions.

---

<div class="post-metadata">

**Author:** ![ahmaddanial](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/ahmaddanial/32/2938_2.png) [@ahmaddanial](https://forum.mattermost.com/u/ahmaddanial)\
**Post date:** [December 1, 2019, 10:57pm UTC](https://forum.mattermost.com/t/how-to-create-new-channel-via-api/6171/3 "2019-12-01T22:57:36Z")

</div>

Hi, everyone.

For reference purposes, please refer to the cURL command below as an example. Change the `"type"` to P or O depending on the channel privacy:

```auto
ahmaddanial@mattermost:~$ curl -i -X POST -H 'Content-Type: application/json' -d '{"team_id":"<team_id>", "name":"<channel_name>", "display_name":"<display_name>", "purpose":"<channel_purpose>", "header":"<channel_header>", "type":"P"}' -H 'Authorization: Bearer <access_token>' <url>/api/v4/channels
HTTP/1.1 201 Created
Content-Type: application/json
Vary: Accept-Encoding
X-Request-Id: pta3qxazqp8d5xai3am86mtdhy
X-Version-Id: 5.17.0.5.17.0.1674c3c52527898789567f15be6ba835.true
Date: Sun, 01 Dec 2019 22:13:18 GMT
Content-Length: 437

{"id":"w8jqfj1qfpfduxk36fbfgp4ayy","create_at":1575238398378,"update_at":1575238398378,"delete_at":0,"team_id":"<team_id>","type":"O","display_name":"<display_name>","name":"<channel_name>","header":"<channel_header>","purpose":"<channel_purpose>","last_post_at":0,"total_msg_count":0,"extra_update_at":0,"creator_id":"dhnntb7j8f8wjnf8ttqqk64kao","scheme_id":null,"props":null,"group_constrained":null}

```

---

<div class="post-metadata">

**Author:** ![PavanButke](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/pavanbutke/32/7566_2.png) [@PavanButke](https://forum.mattermost.com/u/PavanButke)\
**Post date:** [January 29, 2024, 5:28pm UTC](https://forum.mattermost.com/t/how-to-create-new-channel-via-api/6171/4 "2024-01-29T17:28:41Z")

</div>

can’t we create channel using websocket