v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-211931021.7 MB

Knowledge Articles

Create a new Knowledge Article

OAuth Scope

This endpoint requires the following OAuth scope manage_knowledge.

Record UUID

UUID is optional for record creation. If no UUID is supplied, a UUID will be automatically generated for the new record and returned in the x-record-uuid response header.

post/knowledgearticle.json

Request body

uuidstring uuid

Unique identifier for this record

namestring required

Title of the knowledge article. This is a mandatory field with a maximum length of 100 characters. Used for identifying and searching for articles in the knowledge base.

contentstring

The main content of the knowledge article. For 'richtext' and 'pdf' articles, this contains HTML formatted text. For 'video' articles, this may contain supplementary information. For 'call' articles, this contains call details. Supports extended text length.

article_typestring

Type of knowledge article. Valid values are 'video', 'richtext', 'pdf', or 'call'. This determines how the article content is presented and processed in the system.

tagsstring

Comma-separated list of tags associated with this knowledge article. Maximum length is 2000 characters. Tags are used for categorization, searching, and automatic relationship generation with other objects like Services, Materials, and Companies.

Example request

{
  "uuid": "123e4567-835b-490f-a521-23f94a1d1efb"
}

Response

Success

errorCodenumber

messagestring

Example response

{
  "message": "OK"
}