Create Knowledge Base Page

CUSTOM-ENDPOINT

POST https://api.speakap.io/networks/:eid/pages/

CUSTOM-REQUEST

  • URI: /networks/{networkEID}/pages/
  • Method: POST
  • Content-Type: application/json
  • Authentication: OAuth 2.0

Parameters

NameTypeDescription
networkEIDEIDNetwork EID

Request Body

Supply a complete knowledge base page resource in the request body.

NameTypeDescription
titlestringTitle of page. It's a required field.
bodyhtmlThe body of page. It's a required field.
iconstringThe name of the icon of the page. It's a required field.
statusstringThe status of the page. Published or draft. It's a required field.
pageTypestringThe type of the page. It must be knowledge_base. It's a required field.
knowledgeBaseCategoryarrayA list of categories. Although it's a list, should be a list of a single element. It's a required field
recipientsarrayList of recipient objects (groups or network). It's a required field
recipients[i].EIDEIDEID of the recipient (group or network)
recipients[i].typestringgroup or network
coverImagemessageIdentityA cover image for the page. It's optional.
coverImage.EIDEIDEID of the uploaded file
coverImage.typestringmessage

Example (knowledge base page)

{
    "body": "The body here",
    "icon": "car",
    "recipients": [
        {
          "EID": "{{NetworkEID}}",
          "type": "network"
        }
    ],
    "knowledgeBaseCategories": ["{{CategoryEID}}"],
    "title": "Auto",
    "status": "published",
    "pageType": "knowledge_base",
    "coverImage": {
        "EID": "{{FileEID}}",
        "type": "message"
    }
}

Response

StatusData
201Accepted for insertions: returns a Feedback object
400Invalid data: returns an Error object
401Unauthorized: returns an Error object
403Forbidden: returns an Error object
404Unknown network: returns an Error object