Create Post

POST {{baseUrl}}/api/v2/community/posts

Adds a post to the specified topic.

Allowed for

  • End users

Agents with the Help Center manager role can optionally supply an author_id as part of the post object. If it is provided, the post's author will be set to the value of the author_id key.

Agents with the Help Center manager role can optionally supply a created_at as part of the post object. If it is not provided created_at is set to the current time.

Supplying a notify_subscribers property with a value of false will prevent subscribers to the post's topic from receiving a post creation email notification. This can be helpful when creating many posts at a time. Specify the property in the root of the JSON object, not in the post object. Optionally, you can attach existing content tags by specifying their ids.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: Created

{"post":{"title":"\u003cstring\u003e","author_id":"\u003cinteger\u003e","closed":"\u003cboolean\u003e","comment_count":"\u003cinteger\u003e","content_tag_ids":["\u003cinteger\u003e","\u003cinteger\u003e"],"created_at":"\u003cdateTime\u003e","details":"\u003cstring\u003e","featured":"\u003cboolean\u003e","follower_count":"\u003cinteger\u003e","html_url":"\u003cstring\u003e","id":"\u003cinteger\u003e","non_author_editor_id":"\u003cinteger\u003e","non_author_updated_at":"\u003cdateTime\u003e","pinned":"\u003cboolean\u003e","status":"\u003cstring\u003e","topic_id":"\u003cinteger\u003e","updated_at":"\u003cdateTime\u003e","url":"\u003cstring\u003e","vote_count":"\u003cinteger\u003e","vote_sum":"\u003cinteger\u003e"}}