Description

n8n ContentStudio Nodes

This package provides n8n community nodes for integrating with ContentStudio API, enabling workflow automation for social media management.

Installation

In n8n (Recommended)

1. Go to Settings > Community Nodes
2. Click Install
3. Enter package name: n8n-nodes-contentstudio
4. Click Install

Via npm

npm install n8n-nodes-contentstudio

Prerequisites

• n8n version 0.187.0 or later
• ContentStudio account with API access
• ContentStudio API key

Credentials

This node requires a ContentStudio API key:

1. API Key: Your ContentStudio X-API-Key

The API base URL is built into the node, so users only need to provide their API key.

Operations

Resources

• Auth: Validate API key
• Workspace: List workspaces
• Social Account: List social accounts
• Post: Create, list, and delete posts

Post Operations

#### Create Post

• Content Text: Post content/caption
• Media Images: Add multiple image URLs
• Media Video: Add video URL
• Accounts: Select social media accounts
• Publish Type: Scheduled (with date/time)

#### List Posts

• Workspace: Select workspace
• Date filters: Optional date range filtering

#### Delete Post

• Workspace: Select workspace
• Post ID: Enter post ID to delete

Features

• Dynamic Dropdowns: Auto-populated workspace and account selections
• User-Friendly Media Input: Easy image and video URL management
• Content Validation: Ensures at least one content type is provided
• Date Validation: Proper scheduling format enforcement
• Error Handling: Comprehensive error messages and validation

API Compatibility

This node works with ContentStudio API v1 and supports:

• Multiple API response formats
• Various entity identifier fields (id, _id, uuid)
• Robust error handling and fallbacks

Example Workflow

1. List Workspaces → Get available workspaces
2. List Social Accounts → Get connected social media accounts
3. Create Post → Schedule content across multiple platforms
4. List Posts → Monitor created posts
5. Delete Post → Remove posts when needed

Support

• Issues: GitHub Issues
• Documentation: ContentStudio API Docs
• n8n Community: n8n Community Forum

Releasing

Publishing to npm is automated via .github/workflows/publish.yml using npm Trusted Publishing (OIDC) — no tokens required.

The workflow does NOT run on PR merges (to main or any other branch). It runs only when:

1. A tag matching v* is pushed — e.g. v2.0.8, v2.1.0. This is the normal release path.
2. It is triggered manually from the Actions tab on GitHub (workflow_dispatch).

Release steps

1. Merge your changes into main as normal — nothing publishes yet.
2. Bump version in package.json and merge that commit.
3. Tag the commit and push the tag:

   git tag v2.0.8
   git push origin v2.0.8
   

4. The tag push triggers the workflow → builds, publishes n8n-nodes-contentstudio@ to npm with provenance.
5. Watch progress at: https://github.com/d4interactive/n8n-nodes/actions

License

MIT

Keywords

n8n, workflow, contentstudio, social media, automation, api, content management