Discuss Kit icon

Discuss Kit

Consume Discuss Kit API

Overview

This node integrates with the Discuss Kit API to manage blog content programmatically. Specifically, for the Blog - Create operation, it allows users to create and publish new blog posts within a specified board or category. This is useful for automating content publishing workflows, such as posting scheduled articles, syncing external content sources, or managing blogs in bulk.

Practical examples include:

  • Automatically creating and publishing blog posts from an RSS feed.
  • Creating internal company announcements as blog posts.
  • Managing multilingual blog content by specifying language and slug.

Properties

Name Meaning
Title The title of the blog post to be created.
Content The main content of the blog post, provided as a JSON string.
Board The ID of the board (category or section) where the blog post will be placed.
Labels Comma-separated list of labels/tags associated with the blog post.
Assignees Comma-separated list of assignee identifiers (DIDs) responsible for the blog post.
Publish Boolean flag indicating whether to immediately publish the blog post after creation.
Language The language code (e.g., "en") representing the language of the blog content.
Slug A URL-friendly identifier (slug) for the blog post, used in URLs and routing.

Output

The output is a JSON object representing the newly created blog post as returned by the Discuss Kit API. It includes all relevant details such as the blog's ID, title, content, labels, assignees, publication status, language, slug, and other metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires access to the Discuss Kit API endpoint.
  • Needs an API authentication token or key configured in n8n credentials to authorize requests.
  • Uses the blockletComponentApiRequest helper function to perform HTTP requests to the Discuss Kit backend.

Troubleshooting

  • Common issues:

    • Missing required fields like Title or Content will cause the API to reject the request.
    • Invalid or missing API credentials will result in authentication errors.
    • Providing an invalid Board ID may cause the blog post to be assigned to a default board or fail.
    • Incorrectly formatted JSON content can lead to parsing errors on the server side.
  • Error messages:

    • "Unauthorized" or "Authentication failed": Check that the API key credential is correctly set up.
    • "Validation error": Ensure all required properties are provided and valid.
    • "Board not found": Verify the Board ID exists and is accessible.
    • Network timeouts or connection errors: Confirm network connectivity and API availability.

Links and References

Discussion