Skip to main content

Simple Bluesky multi-image post using native Bluesky API

Workflow preview

Workflow preview
100%
Simple Bluesky multi-image post using native Bluesky API preview
Open on n8n.io

Important notice

This workflow is provided as-is. Please review and test before using in production.

1. Workflow Overview

Who is this workflow for? This workflow is the baseline workflow for anyone who needs to automate the process of posting 1 4 images to Bluesky using the Bluesky API. It is ideal for anyone looking ...

Best for

  • Social Media automation workflows
  • advanced n8n builders looking for reusable templates

Tools used

n8n-nodes-base.manualtrigger, n8n-nodes-base.httprequest, n8n-nodes-base.code, n8n-nodes-base.stickynote, n8n-nodes-base.splitout, n8n-nodes-base.set, n8n-nodes-base.aggregate

Source and attribution

This workflow is cataloged by N8N Workflows and links back to its original n8n.io source page by Tom Sekula.

Original n8n.io source

1.1 Workflow description

Title
Simple Bluesky multi-image post using native Bluesky API
Workflow name
Simple Bluesky multi-image post using native Bluesky API

Who is this workflow for?

This workflow is the baseline workflow for anyone who needs to automate the process of posting 1-4 images to Bluesky using the Bluesky API. It is ideal for anyone looking to streamline their social media posting process, saving time and ensuring consistent content delivery.

Use Case / Problem Solved

Manually posting images and captions on Instagram can be time-consuming, especially for businesses and content creators managing multiple accounts. This workflow automates the process from image preparation to publishing, reducing manual effort and increasing efficiency.

What this workflow does

  1. Trigger Initialization: The workflow starts with a manual trigger that can be adapted to other triggers (e.g., HTTP webhook or schedule).
  2. Set Parameters: The workflow includes a node that sets essential parameters, such as the Bluesky account ID, image URLs, and caption.
  3. Prepare Bluesky Session: A node creates the authenticated session data used by the upload and post operations later in the workflow.
  4. Publish Media: Nodes retrieve image files from the specified URLS and uploads them as blobs to Bluesky, a necessary pre-requisite for a Bluesky post to have images attached.
  5. Post text caption + images: A node does the final call to the Bluesky API, including the text caption and relevant image references.

Setup

  1. Sign-in to Bluesky and create an App Password
  2. Add your username and App Password to the Define Credentials node.
  3. Set the caption (text content) of your post in the Set Caption node.
  4. Set 1-4 image URLs in the Set Images node
  5. Adapt the initial trigger as needed to fit your workflow's requirements (e.g., schedule, webhook).
  6. Adapt the caption and images nodes to accept dynamic parameters.

Limitations

This workflow assumes a minimum of 1 image URL to function. If you want a text-only post, remove the whole embed section from the JSON in last Post to Bluesky node, as well as relevant image attachment nodes.

The 300-character limit in Bluesky includes the caption + hashtags + image alt text. Going over 300 will return a Record/description must not be longer than 300 graphemes error.

1.2 Logical Blocks

This catalog entry is organized from the workflow JSON. The node-level section below shows the executable blocks available for review before importing the template.

2. Block-by-Block Analysis

Block 1 - When clicking ‘Test workflow’

Type / Role
n8n-nodes-base.manualTrigger - manualTrigger
Config choices
Version 1

Block 2 - Create Bluesky Session

Type / Role
n8n-nodes-base.httpRequest - httpRequest
Config choices
Version 4.2

Block 3 - Download Images

Type / Role
n8n-nodes-base.httpRequest - httpRequest
Config choices
Version 4.2

Block 4 - Code

Type / Role
n8n-nodes-base.code - code
Config choices
Version 2

Block 5 - Sticky Note

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 6 - Split Out

Type / Role
n8n-nodes-base.splitOut - splitOut
Config choices
Version 1

Block 7 - Post to Bluesky

Type / Role
n8n-nodes-base.httpRequest - httpRequest
Config choices
Version 4.2

Block 8 - Sticky Note1

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 9 - Sticky Note2

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 10 - Define Credentials

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 11 - Aggregate

Type / Role
n8n-nodes-base.aggregate - aggregate
Config choices
Version 1

Block 12 - Set Images

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 13 - Post Image to Bluesky

Type / Role
n8n-nodes-base.httpRequest - httpRequest
Config choices
Version 4.2

Block 14 - Sticky Note3

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 15 - Set Caption

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

3. Summary Table

Workflow Simple Bluesky multi-image post using native Bluesky API
Complexity advanced
Nodes 15
Categories Social Media
Author Tom Sekula
Published 21 Nov 2024

4. Reproducing the Workflow from Scratch

  1. 1. Download the workflow JSON

    Use the JSON export at /data/workflows/2562/2562.json as the source template for this automation.

  2. 2. Import the template into n8n

    Open n8n, import the downloaded JSON, and review each node before activating the workflow.

  3. 3. Configure credentials and variables

    Replace placeholder credentials, API keys, webhook URLs, account IDs, and environment-specific values with your own settings.

  4. 4. Test with sample data

    Run the workflow manually or in a staging workspace, inspect node output, and confirm downstream systems receive the expected data.

  5. 5. Activate and monitor

    Enable the workflow only after testing, then monitor executions, errors, and rate limits during the first production runs.

5. General Notes & Resources

Review imported nodes carefully before activation. This catalog entry is intended to help you inspect the workflow structure, understand required services, and find related templates faster.

Node names, credentials, schedules, webhook paths, and external service limits may need adjustment for your workspace.

Frequently asked questions

What does Simple Bluesky multi-image post using native Bluesky API do?

Who is this workflow for? This workflow is the baseline workflow for anyone who needs to automate the process of posting 1 4 images to Bluesky using the Bluesky API. It is ideal for anyone looking ...

What do I need before importing this workflow?

Review the workflow JSON, configure any required credentials in n8n, and test the automation in a safe workspace before using it in production.

Can I customize this workflow?

Yes. Use the block-by-block analysis and the downloadable JSON to inspect each node, then adjust credentials, prompts, schedules, filters, or destinations for your Social Media use case.