Auto Socials Post Node for n8n

This is an n8n community node that provides integration with the Auto Socials Post API, allowing you to automate video uploads and scheduling across multiple social media platforms.

Features

• Upload files to multiple social media platforms
• Check upload job status
• Wait for job completion with automatic polling
• List all upload jobs for a project
• Create scheduled upload jobs
• Create multiple scheduled jobs in batch
• List scheduled upload jobs

Installation

Follow these steps to install this node:

Option 1: Install from npm

npm install n8n-nodes-auto-socials-post

Option 2: Install from packaged file (.tgz)

If you have a packaged version of this node (e.g., n8n-nodes-auto-socials-post-1.0.0.tgz):

1. Stop n8n if it's currently running

2. Install the package using one of these methods:

   Global installation (if n8n is installed globally):

   npm install -g /path/to/n8n-nodes-auto-socials-post-1.0.0.tgz
   

   Local installation (if n8n is in a specific directory):

   cd /path/to/your/n8n/installation
   npm install /path/to/n8n-nodes-auto-socials-post-1.0.0.tgz
   

3. Restart n8n to load the new node

4. Verify installation - You should see "Auto Socials Post" available in the node palette

Option 3: Install from source

1. Clone this repository:

git clone https://github.com/username/n8n-nodes-auto-socials-post.git

2. Navigate to the project directory:

cd n8n-nodes-auto-socials-post

3. Install dependencies:

npm install

4. Build the node:

npm run build

5. Create a package:

npm pack

6. Install the generated .tgz file using the instructions in Option 2 above

Option 4: Development installation

For development purposes:

1. Follow steps 1-4 from Option 3
2. Link to your n8n installation:

npm link

3. In your n8n installation directory:

npm link n8n-nodes-auto-socials-post

Configuration

1. In your n8n instance, go to Settings > Community Nodes
2. Click Install
3. Enter n8n-nodes-auto-socials-post and click Install
4. Restart n8n

Credentials

To use this node, you need to create credentials for the Auto Socials Post API:

1. In n8n, go to Credentials and click Create New
2. Search for "Auto Socials Post API" and select it
3. Enter your API key and base URL (default: http://localhost:3000)
4. Save the credentials

Usage

Create Upload Job

Uploads a video file and creates an upload job.

Parameters:

• Title: Title of the video
• Description: Description of the video (optional)
• Platforms: Social media platforms to post to (x, linkedin)
• Tags: Comma-separated tags (optional)
• Binary Property: Name of the binary property containing the video file
• Posting Options: JSON formatted posting options (optional)

Example:

{
  "x": {
    "tweet": "Check out my new video!"
  },
  "linkedin": {
    "message": "New content for my professional network"
  }
}

Get Job Status

Checks the status of an existing upload job using the API key authentication.

Parameters:

• Job ID: ID of the job to check

Wait for Job Completion

Polls job status until completion or timeout.

Parameters:

• Job ID: ID of the job to monitor
• Maximum Wait Time: Maximum time to wait in minutes (default: 10)
• Poll Interval: Time between status checks in seconds (default: 30, minimum: 10)

List Jobs

Lists all upload jobs for a project.

Parameters:

• Limit: Maximum number of jobs to return (default: 50)
• Offset: Number of jobs to skip (default: 0)

Create Scheduled Job

Creates a job with scheduled posting time.

Parameters:

• Title: Title of the video
• Description: Description of the video (optional)
• Platforms: Social media platforms to post to
• Video URL: URL of the video file
• Thumbnail URL: URL of the thumbnail image (optional)
• Scheduled Time: ISO 8601 formatted datetime for posting
• Tags: Comma-separated tags (optional)
• Metadata: JSON formatted metadata (optional)
• Posting Options: JSON formatted posting options (optional)

Create Batch Scheduled Jobs

Creates multiple scheduled jobs in batch.

Parameters:

• Jobs Data: JSON array of job objects

Example:

[
  {
    "title": "First Video",
    "platforms": ["x"],
    "videoUrl": "https://example.com/video1.mp4",
    "scheduledAt": "2024-12-01T12:00:00Z"
  },
  {
    "title": "Second Video",
    "platforms": ["linkedin"],
    "videoUrl": "https://example.com/video2.mp4",
    "scheduledAt": "2024-12-01T13:00:00Z"
  }
]

List Scheduled Jobs

Lists all scheduled jobs.

Parameters:

• Limit: Maximum number of jobs to return (default: 50)
• Offset: Number of jobs to skip (default: 0)

Example Workflows

Basic Video Upload

1. Add a Read Binary File node to load your video file
2. Connect it to the Auto Socials Post node
3. Configure the node with operation "Create Upload Job"
4. Set your Title, Platforms, and Binary Property
5. Execute the workflow to upload your video

Upload and Wait for Completion

1. Add a Read Binary File node to load your video file
2. Connect it to the Auto Socials Post node with "Create Upload Job" operation
3. Add another Auto Socials Post node
4. Configure it with operation "Wait for Job Completion"
5. Use an expression to get the Job ID from the previous node: {{ $node["Auto Socials Post"].json.id }}
6. Execute the workflow to upload and wait for completion

Scheduled Posting

1. Add an Auto Socials Post node
2. Configure it with operation "Create Scheduled Job"
3. Set Title, Platforms, Video URL, and Scheduled Time
4. Execute the workflow to schedule your post

Troubleshooting

Common Issues

Authentication Errors

• Verify your API key is correct
• Check that your base URL is properly configured

File Upload Failures

• Ensure your file is in a supported format (mp4, avi, mov, wmv, webm, mkv)
• Check that the file size is within limits (default max: 100MB)
• Verify the binary property name matches the property containing your file

Polling Timeouts

• Increase the Maximum Wait Time for large video files
• Check your network connection
• Verify the job hasn't failed on the server side

JSON Parsing Errors

• Validate your JSON format for Posting Options, Metadata, and Jobs Data
• Use a JSON validator to check your syntax

API Response Codes

• 200: Success
• 400: Bad Request (invalid parameters)
• 401: Unauthorized (invalid API key)
• 404: Not Found (job or project not found)
• 413: Payload Too Large (file size exceeds limit)
• 429: Too Many Requests (rate limit exceeded)
• 500: Internal Server Error

Development

Building

npm run build

Testing

npm test

Linting

npm run lint

License

MIT

API Documentation

For more details about the Auto Socials Post API, refer to the official API documentation.

Changelog

1.0.0 (2024-07-17)

• Initial release with all core functionality
• Support for video uploads and scheduling
• Comprehensive error handling and validation
• Polling mechanism for job completion