# How to create new topic by API

**URL:** <https://meta.discourse.org/t/how-to-create-new-topic-by-api/146849>\
**Category:** Development\
**Created:** [April 4, 2020, 10:49pm UTC](https://meta.discourse.org/t/how-to-create-new-topic-by-api/146849 "2020-04-04T22:49:35Z")\
**Posts on this page:** 1\
**Showing post:** 4

<div class="post-metadata">

**Author:** ![Canapin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/canapin/32/119591_2.png) [@Canapin](https://meta.discourse.org/u/Canapin)\
**Post date:** [April 6, 2020, 5:06pm UTC](https://meta.discourse.org/t/how-to-create-new-topic-by-api/146849/4 "2020-04-06T17:06:41Z")

</div>

How do you want to make the request?

Here’s a working example with [Postman](https://www.postman.com/):

1. Create a new POST request.
2. In the POST field, write your forum URL, with /posts/ : `https://yourforum.com/posts/`
3. In Headers tab, set two keys: Api-Key and Api-Username. For the values, use the API key you created in your Discourse administration and an administrator account username.  
 ![image](https://global.discourse-cdn.com/meta/original/3X/c/c/ccfa10a887d29ec0a34f95c54c1db6eed6ec3131.png)
4. In Params tab, set at least these 3 keys: title, raw and category. More info on the [Discourse API doc](https://docs.discourse.org/#tag/Posts/paths/~1posts.json/post):  
 ![image](https://global.discourse-cdn.com/meta/original/3X/6/2/624d58440812263b98ac192e713a60851e4f0f2d.png)
5. Click “Send”. The request is successful:  
 ![image](https://global.discourse-cdn.com/meta/original/3X/d/6/d631022ecbbbbcd70dd4de35c5ef5a8037984d42.png)  
And the topic created:  
 ![image](https://global.discourse-cdn.com/meta/original/3X/f/f/ff83d46ab0d136c3f3cc872d2777d0ffc0fff3f5.png)

---

_[View the full topic](https://meta.discourse.org/t/how-to-create-new-topic-by-api/146849)._