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 body
required

  • body
    object

    Rich text content as TipTap JSON

    • meta
      object

      Additional metadata

      • slug
        string
        required

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

      • type
        enum
        required

        Required. Resource type. One of: post

        One of: post

      • title
        string
        required

        Required. Display title. 1-500 characters

      • locale
        string

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

      • status
        enum

        One of: draft, published, archived, scheduled

        One of: draftpublishedarchivedscheduled

      • tagIds
        array<string>

        Array of strings

      • excerpt
        string

        Short summary for previews

      • ogImage
        string

        Open Graph image URL for social sharing. Max 1000 characters

      • keywords
        string

        Comma-separated SEO keywords. Max 500 characters

      • authorUrl
        union

        Author profile or website URL

      • metaTitle
        string

        Custom meta title for SEO. Max 255 characters

      • authorName
        union

        Display name of the author

      • customData
        union

        Custom fields data (structured content)

      • categoryIds
        array<string>

        Min 1 character. Array of strings

      • faqSettings
        object

        FAQ detection and JSON-LD settings

        • disabledIds
          array<string>
      • jsonLdGraph
        array<object>

        Max 50 characters. Array of objects

        • id
          string
        • data
          any
          required
        • type
          string
          required
        • source
          enum

          One of: presetcustom

      • scheduledAt
        string

        Scheduled publication datetime (ISO 8601)

      • bodyMarkdown
        string

        Content as Markdown (converted to TipTap JSON on save)

      • canonicalUrl
        string

        Canonical URL override. Max 1000 characters

      • displayOrder
        number

        Number

      • featuredImage
        string

        Featured image URL

      • metaDescription
        string

        Meta description for search engines. Max 500 characters

      • jsonLdExclusions
        array<string>

        Max 50 characters. Array of strings

      • translationGroupId
        string

        Translation group UUID (links translations across locales)

      Feedback

      Was this page helpful?