Create a content

Creates a new content in `draft` status by default. You must provide at least a `title` and `type` (currently only `"post"` is supported). The `slug` is auto-generated from the title if not provided. If a slug collision occurs, a numeric suffix is appended (e.g., `my-post-2`). Submit the body as markdown via `bodyMarkdown`. The API converts it to TipTap JSON internally. Alternatively, submit raw TipTap JSON via `body` for advanced formatting control.

Required permissions
contents.create
POST/contents
Base URLhttps://api.lynkow.com/v1

Request bodyrequired

  • bodyobject

    Rich text content as TipTap JSON

    • metaobject

      Additional metadata

      • slugstringrequired

        Required. URL-friendly identifier, unique per site and locale. 1-500 characters

      • typeenumrequired

        Required. Resource type. One of: post

        One of: post

      • titlestringrequired

        Required. Display title. 1-500 characters

      • localestring

        BCP 47 locale code (e.g. "en", "fr")

      • statusenum

        One of: draft, published, archived, scheduled

        One of: draftpublishedarchivedscheduled

      • tagIdsarray<string>

        Array of strings

      • excerptstring

        Short summary for previews

      • ogImagestring

        Open Graph image URL for social sharing. Max 1000 characters

      • keywordsstring

        Comma-separated SEO keywords. Max 500 characters

      • authorUrlunion
      • metaTitlestring

        Custom meta title for SEO. Max 255 characters

      • authorNameunion
      • customDataunion

        Custom fields data (structured content)

      • categoryIdsarray<string>

        Min 1 character. Array of strings

      • faqSettingsobject

        FAQ detection and JSON-LD settings

        • disabledIdsarray<string>
      • jsonLdGrapharray<object>

        Max 50 characters. Array of objects

        • idstring
        • dataanyrequired
        • typestringrequired
        • sourceenum

          One of: presetcustom

      • scheduledAtstring

        Scheduled publication datetime (ISO 8601)

      • bodyMarkdownstring

        Content as Markdown (converted to TipTap JSON on save)

      • canonicalUrlstring

        Canonical URL override. Max 1000 characters

      • displayOrdernumber

        Number

      • featuredImagestring

        Featured image URL

      • metaDescriptionstring

        Meta description for search engines. Max 500 characters

      • jsonLdExclusionsarray<string>

        Max 50 characters. Array of strings

      • translationGroupIdstring

        Translation group UUID (links translations across locales)

      Feedback

      Was this page helpful?