How to use the Postoria n8n integration

The Postoria n8n integration lets you build automated social media publishing workflows in n8n without calling the Postoria Public API manually.

You can use the official Postoria community node to list workspaces and social accounts, upload or import media, publish posts immediately, schedule posts, add posts to queues, list existing posts, check post status, and delete posts in Postoria.

The integration is available on Pro and Agency plans.

Current availability

The Postoria package is available on npm as:

@postoria/n8n-nodes-postoria

At the time of writing, the package is awaiting verification by n8n.

This means:

  • Self-hosted n8n: You can install and use the package now through Settings → Community Nodes.
  • n8n Cloud: Installation will become available after n8n approves the package as a verified community node.

Before you start

You need:

  • An active Postoria Pro or Agency plan.
  • A Postoria Public API key.
  • Access to a self-hosted n8n instance while verification is pending.
  • An n8n Owner or Admin account to install community nodes.

The Postoria node connects directly to the Postoria Public API. Your API key is stored in the n8n credentials system.

Install the Postoria node in self-hosted n8n

  1. Open your self-hosted n8n instance.
  2. Go to Settings.
  3. Open Community Nodes.
  4. Click Install.
  5. Enter the package name:

@postoria/n8n-nodes-postoria

  1. Confirm that you understand the risks of installing a community package.
  2. Click Install.

After installation, search for Postoria in the node panel and add it to a workflow like any other n8n node.

Some self-hosted deployments may require an n8n restart after installation. If your n8n deployment uses queue mode, make sure the same package version is installed for every worker that can execute the workflow.

Create a Postoria Public API key

  1. Open Postoria Settings.
  2. Find the Public API section.
  3. Click Create API key.
  4. Copy the key and store it securely.

Postoria shows the full key only once. After closing the dialog, you will only see its prefix.

If you lose the key, revoke it and create a new one.

You can learn more about API keys and API behavior in the Postoria Public API help article.

Add Postoria credentials in n8n

  1. Create a workflow in n8n.
  2. Add the Postoria node.
  3. In the credential field, choose Create new credential.
  4. Select Postoria API.
  5. Paste your Postoria Public API key.
  6. Run the credential test.
  7. Save the credential.

The same credential can be reused by multiple Postoria nodes in your n8n workflows.

Create your first Postoria workflow

A simple first workflow is to list the Postoria workspaces available to your account.

  1. Add a Manual Trigger node.
  2. Add a Postoria node and connect it to the trigger.
  3. Select:
    • Resource: Workspace
    • Operation: Get Many
  4. Select your Postoria credential.
  5. Click Execute workflow.

The output contains the available workspace IDs, names, and time zones. Other Postoria operations use the workspace you select in the node.

Available resources and operations

The Postoria node currently supports these resources:

Workspace

  • Get Many — list the workspaces available to your Postoria account.

Social Account

  • Get Many — list the social accounts connected to a selected workspace.

Use the returned account IDs when creating posts.

Queue

  • Get Many — list the publishing queues in a selected workspace.

Use the returned queue ID when adding a post to a queue.

Media

  • Upload Binary — upload binary data received from another n8n node.
  • Import From URL — import media from a public HTTPS URL.
  • Get — retrieve a media item and check its current status.

Post

  • Create — publish now, schedule a post, or add a post to a queue.
  • Get — retrieve a post by ID.
  • Get Many — list posts with optional filters and pagination.
  • Delete — delete a post from Postoria.

Deleting a Postoria post does not remove content that has already been published on a social network.

Publish a post immediately

  1. Add a Postoria node.
  2. Select:
    • Resource: Post
    • Operation: Create
  3. Select the workspace.
  4. Set Publish Mode to Publish Now.
  5. Select one or more social accounts.
  6. Add the caption and any optional post settings.
  7. Add media IDs when the post includes uploaded or imported media.
  8. Execute the node.

The node returns the created Postoria post and its initial status.

Schedule a post

  1. Select:
    • Resource: Post
    • Operation: Create
  2. Select the workspace and social accounts.
  3. Set Publish Mode to Schedule.
  4. Enter the scheduled date and time.
  5. Add the caption, media, link, and any network-specific settings.
  6. Execute the node.

You can use an n8n expression for a relative schedule. For example, this expression schedules the post two hours after the workflow runs:

{{ $now.plus({ hours: 2 }).toISO() }}

Add a post to a queue

  1. Select:
    • Resource: Post
    • Operation: Create
  2. Select the workspace.
  3. Set Publish Mode to Add to Queue.
  4. Select the queue.
  5. Select the social accounts.
  6. Add the post content.
  7. Execute the node.

The queue must already exist in the selected Postoria workspace. You can create and manage queues in the Postoria web app.

Import media from a public URL

Use Media → Import From URL when an image, video, or document is already available through a public HTTPS URL.

  1. Add a Postoria node before the post creation node.
  2. Select:
    • Resource: Media
    • Operation: Import From URL
  3. Select the workspace.
  4. Enter the public HTTPS URL.
  5. Execute the node.

The node starts the media import and checks the processing status automatically. It returns only after the media is ready to use or the processing timeout is reached.

Map the returned file_id into the Media IDs field of the Postoria node that creates the post.

Upload binary media

Use Media → Upload Binary when a previous n8n node provides the file as binary data.

For example, the binary data may come from an HTTP Request node, cloud storage node, webhook, form submission, or another file-processing step.

  1. Connect the node that provides the binary file to a Postoria node.
  2. Select:
    • Resource: Media
    • Operation: Upload Binary
  3. Select the workspace.
  4. Enter the name of the binary property. The default is data.
  5. Execute the node.

The Postoria node performs the complete upload process:

  1. Creates a Postoria media upload.
  2. Uploads the binary file.
  3. Completes the upload.
  4. Checks the processing status every five seconds.
  5. Returns the media after it reaches the ready status.

The default processing timeout is 600 seconds. You can change it in the node settings when a large file needs more time.

Supported upload formats include JPEG, PNG, WebP, GIF, MP4, MOV, and PDF.

After the upload completes, map the returned file_id into the Media IDs field of the post creation node.

Date and time zone behavior

Postoria interprets scheduled dates using the n8n workflow time zone.

Before scheduling posts, open the workflow settings in n8n and confirm that the workflow time zone is correct.

The node handles dates as follows:

  • A date containing Z is treated as UTC.
  • A date containing an explicit offset preserves that exact moment.
  • A local date without an offset is interpreted in the n8n workflow time zone and then converted to UTC before it is sent to Postoria.

For example:

2026-08-01T12:00:00+03:00 → 2026-08-01T09:00:00.000Z

Using the workflow time zone helps prevent scheduled posts from shifting when the n8n server runs in a different region.

Use Postoria as an AI Agent tool

The Postoria node can also be connected to the Tool input of an n8n AI Agent.

  1. Add an AI Agent node.
  2. Connect a supported Chat Model.
  3. Click the Tool connector on the AI Agent.
  4. Add the Postoria node.
  5. Select the Postoria resource and operation the agent is allowed to use.

A simple safe example is:

  • Resource: Workspace
  • Operation: Get Many

The agent can then respond to a request such as:

List my Postoria workspaces.

For actions that publish, schedule, queue, or delete posts, review the selected workspace, social accounts, content, media, and scheduled time before running the workflow.

Example workflow ideas

The Postoria node can be combined with other n8n nodes to build workflows such as:

  • Import a new article from a CMS and schedule a social media post.
  • Read approved posts from Google Sheets and add them to a Postoria queue.
  • Receive a webhook, import an image, and publish a post immediately.
  • Download media from cloud storage and upload it to Postoria.
  • Generate a caption with an AI node and send it to Postoria for review or publishing.
  • List scheduled posts and send a daily summary to email or Slack.

Package and source code

The npm package is available here:

https://www.npmjs.com/package/@postoria/n8n-nodes-postoria

The integration is open source on GitHub:

https://github.com/postoria-app/n8n-nodes-postoria