Substack icon

Substack

Interact with Substack API

Actions15

Note → Create Note

AI-generated

Overview

This node operation allows users to create a note on the Substack platform. It supports adding textual content with optional Markdown formatting, setting the visibility of the note (public or subscribers-only), and attaching a link to the note if desired. This is useful for content creators who want to programmatically publish notes with rich text and attachments to their Substack publication.

Use Case Examples

  1. Creating a simple text note visible to everyone.
  2. Creating a Markdown-formatted note with bold and italic text, visible only to subscribers.
  3. Creating a note with an attached URL link for additional reference or resources.

Properties

Name Meaning
Body The content of the note. Must contain at least one paragraph with actual content. Supports Markdown formatting in Advanced mode.
Content Type Choose how to format the content, either as simple plain text or advanced Markdown formatting.
Visibility Defines who can see the note, either everyone (public) or only subscribers.
Attachment Option to add an attachment to the note, either none or a link.
Link URL The URL to attach to the note if the attachment type is set to link.

Output

JSON

  • id - Unique identifier of the created note
  • body - Content of the note
  • contentType - Format type of the note content (simple or advanced Markdown)
  • visibility - Visibility setting of the note (everyone or subscribers)
  • attachment - Attachment type added to the note (none or link)
  • linkUrl - URL attached to the note if any

Dependencies

  • Substack API with an API key credential

Troubleshooting

  • Ensure the note body contains at least one paragraph with actual content; empty or invalid content will cause errors.
  • If using advanced Markdown content type, ensure the formatting is valid to avoid note creation failure.
  • When attachment is set to link, the link URL must be a valid URL; otherwise, the operation will fail.
  • Common error messages include unknown resource or operation errors if parameters are incorrectly set, and API errors if authentication or data validation fails.

Discussion