postdot

Prepare Postdot publication drafts from n8n

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0-alpha.4
Author: Postdot

Documentation

Postdot for n8n

Turn text from a feed, form or workflow into a draft in
Postdot. Choose a project and channel in n8n, then review
and schedule the publication in Postdot Studio.

Setup guide ·
Example workflow ·
Install Postdot

This alpha community node works with self-hosted n8n. It is not verified for
n8n Cloud. It creates text drafts and reads projects, channels and publications;
use Studio to add media, schedule and publish.

Install

You need a running Postdot instance that n8n can reach and permission to install community nodes in n8n.

  1. In n8n, open Settings > Community Nodes and select Install.
  2. Enter @postdot/n8n-nodes-postdot as the package name.
  3. Review the community node notice and select Install.

Add a node to your workflow and search for Postdot.

For Docker, queue mode or installations managed from the command line, see n8n's manual installation guide. Use @postdot/n8n-nodes-postdot as the package name and keep the installation in n8n's persistent user directory.

Connect your Postdot instance

In Postdot Studio, open Settings > API keys. Create a key limited to the project you want to use, with these actions:

  • project:read
  • publication:manage

In n8n, create a Postdot API credential and fill in:

Field Value
Postdot URL Your instance address, such as https://postdot.example, without /api or another path.
API Key The secret from the Postdot API key you just created.

Save and test the credential. The test lists accessible projects. Store your API key in the credential so it stays out of workflow parameters and exports.

If n8n runs in Docker, use an address reachable from its container. localhost refers to the n8n container itself.

Create your first draft

  1. Add a Manual Trigger and connect a Postdot node.
  2. Select your Postdot API credential.
  3. Set Resource to Post and Operation to Create Draft.
  4. Select a project and channel, then enter your Text. You can use an n8n expression to read text from an earlier step.
  5. Choose Automatic for a connected publishing destination, or Manual for a channel you publish yourself.
  6. Execute the workflow once, then open Queue in Postdot Studio to review the draft.

Both delivery modes save an unscheduled draft. The node prepares plain text for one channel; review it in Studio before scheduling or publishing. Channels that require media will need further editing.

Create Draft returns a post and a publications array. To read the saved publication in a later node, use Publication > Get with the same project and this Publication ID expression:

{{ $json.publications[0].id }}

You can also download the example workflow and import it into n8n. Select your credential on both Postdot nodes, then replace the project ID, channel ID and text in Draft settings. Use the operations below to find those IDs.

Supported operations

Resource Operation Result
Project Get Many Lists the active projects your API key can access.
Channel Get Many Lists channels attached to the selected project.
Post Create Draft Creates a post and one unscheduled, text-only publication for each input item.
Publication Get Reads a publication's saved draft, state, selected target and recorded outcome.

If a request fails

Keep Retry On Fail disabled for Create Draft. A timeout or lost response may occur after Postdot saves the draft. Check Queue before running the creation again to avoid duplicates. Each input item creates a separate post, including items you send again in another run.

If your projects or channels do not appear, check the API key's project scope and actions. An invalid key returns 401; insufficient permissions can return 403, and a project outside the key's scope can return 404.

Help and license

See the Postdot n8n guide for more setup details, or report an issue with your n8n version, package version and the failing operation. Remove API keys and private content from anything you share.

Licensed under AGPL-3.0-only.

Discussion