Sign in

v1

latestOpenAPI 3.1.02026-07-2665153355.3 KB
Portal Content

Create Content

Creates a new content item.

post/v1/portal-content

Headers

x-publisher-tokenstring required

Publisher token.

Request body

titlestring required

Content title.

subTitlestring

Content description.

bodyTextstring

Content body text.

headerImagestring required

Content header image URL. Can be an external link or the URL of an image from the Assets Library.

thumbnailImagestring required

Content thumbnail image URL. Can be an external link or the URL of an image from the Assets Library.

labelsstring[]

List of labels associated with the content.

state'visible' | 'hidden' | 'scheduled'

Current state of the content.

contentType'article' | 'news' required

Content type.

publishDatestring date-time

Content publish date. Use for scheduling content.

pagesstring[]

List of page IDs where this content will appear. The Page ID can be found in the Pages section of the Publisher Dashboard.

Note: If you don't pass this property, or if you assign the content to a page that doesn't exist, the content will be created but won't be displayed in the Game Portal.

slugstring

Content slug. If not provided, this value is auto-generated.

visibility'public' | 'private'

Content visibility level.

tagstring

Internal tag for organizing your content. Not visible to players.

Example request

{
  "title": "Welcome to Our Game",
  "subTitle": "Everything you need to know",
  "bodyText": "This is the main content body with detailed information about getting started...",
  "headerImage": "https://cdn.example.com/images/header.jpg",
  "thumbnailImage": "https://media.appcharge.com/media/25cb4861ec8924a6b69a0f59/book-shelf1920.jpg",
  "labels": [
    "tutorial",
    "beginner"
  ],
  "state": "visible",
  "contentType": "article",
  "publishDate": "2025-10-20T00:00:00.000Z",
  "pages": [
    "6850249eb5bd5c59b9bab7e2",
    "692eb70d0293e07ab4895518"
  ],
  "slug": "welcome-to-our-game",
  "visibility": "public",
  "tag": "spring2025",
  "translations": [
    {
      "dynamicTranslations": [
        {
          "type": "section",
          "externalId": "my-bundle-1",
          "field": "description",
          "locale": "es-ES",
          "value": "Hola!"
        }
      ],
      "staticTranslations": [
        {
          "key": "checkout.pay_button",
          "locale": "es-ES",
          "value": "Zapłać teraz"
        }
      ]
    }
  ]
}

Response

Content created successfully.

idstring

Content ID.

titlestring

Content title.

subTitlestring

Content description.

bodyTextstring

Content body text.

headerImagestring

Content header image URL.

thumbnailImagestring

Content thumbnail image URL.

labelsstring[]

List of labels associated with the content.

state'visible' | 'hidden' | 'scheduled'

Current state of the content.

contentType'article' | 'news'

Content type.

publishDatestring date-time

Content publish date. Use for scheduling content.

slugstring

Content slug. If not provided, this value is auto-generated.

visibility'public' | 'private'

Content visibility level.

tagstring

Internal tag for organizing your content. Not visible to players.

createdAtstring date-time

Created date.

updatedAtstring date-time

Updated date.

Example response

{
  "id": "507f1f77bcf86cd799439011",
  "title": "Welcome to Our Game",
  "subTitle": "Everything you need to know",
  "bodyText": "This is the main content body with detailed information...",
  "headerImage": "https://cdn.example.com/images/header.jpg",
  "thumbnailImage": "https://media.appcharge.com/media/25cb4861ec8924a6b69a0f59/book-shelf1920.jpg",
  "labels": [
    "tutorial",
    "beginner"
  ],
  "state": "hidden",
  "contentType": "article",
  "publishDate": "2025-10-20T00:00:00.000Z",
  "slug": "welcome-to-our-game",
  "visibility": "public",
  "tag": "spring2025",
  "createdAt": "2025-10-15T10:30:00.000Z",
  "updatedAt": "2025-10-19T14:20:00.000Z",
  "translations": [
    {
      "dynamicTranslations": [
        {
          "type": "section",
          "externalId": "my-bundle-1",
          "field": "description",
          "locale": "es-ES",
          "value": "Hola!"
        }
      ],
      "staticTranslations": [
        {
          "key": "checkout.pay_button",
          "locale": "es-ES",
          "value": "Zapłać teraz"
        }
      ]
    }
  ],
  "pages": [
    {
      "id": "68b0249eb5bd5c59b9bab7e2",
      "pageName": "FAQs"
    },
    {
      "id": "692eb70d0293e07ab4895518",
      "pageName": "Events"
    }
  ]
}