n8n Blotato Node

Install the Blotato n8n node, configure its API credential, verify access, and check asynchronous results.

The official Blotato community node for n8n: https://github.com/Blotato-Inc/n8n-nodes-blotato

---

Available Operations

The Blotato node supports the following operations:

Resource	Operation	Description
Post	Publish	Publish a post to social platforms
Post	Get	Check a post submission's status
Media	Upload	Upload media files
Visual	Create	Create visuals from templates (carousels, slideshows)
Visual	Get	Get visual creation status
Visual	Delete	Delete a visual after the user's authorization
Source	Create	Resolve content from URLs, text, PDFs, etc.
Source	Get	Get source resolution status and content

---

Install the Blotato Node

n8n Cloud Users

1. Use an n8n instance owner or admin account for installation.

2. Open a workflow's node panel.

3. Search for "Blotato".

4. Select the node under "More from the community".

5. Click Install.

If community results are hidden, ask the instance owner to check the verified-community-node setting in the Cloud Admin Panel. Members use nodes after an owner or admin installs them. See n8n's installation instructions.

Self-Hosted n8n Users

1. Use an n8n instance owner or admin account.

2. Open Settings > Community Nodes.

3. Click Install.

4. Enter the package name n8n-nodes-blotato.

5. Review the package and confirm installation.

If community packages are disabled, ask the instance administrator to review N8N_COMMUNITY_PACKAGES_ENABLED. Its default is true. Change deployment settings or restart n8n only with the administrator's approval. See n8n's community-node settings and installation guide.

---

Update the Blotato Node

1. Go to n8n Settings > Community Nodes

2. Find the Blotato node and click Options

3. Click Update

---

Configure and verify the credential

1. Connect the intended social accounts in Accounts.

2. Read API access and authentication before generating a key. Generating a key during a free trial starts paid access.

3. Create or select the node's "Blotato API" credential.

4. Enter the key in its "API Key" field. Do not paste it into workflow text, documentation, or chat.

5. Keep "Blotato Server" set to https://backend.blotato.com. Do not append /v2; the node adds the endpoint path.

6. Save and test the credential.

7. Refresh the account selection in a Publish node and select the intended platform and account.

The credential test calls GET /v2/users/me. Passing it proves authentication, not a completed publication. Verify the account selection separately. If no accounts appear, inspect account lookup rather than creating a test post.

Verify a publication

1. After an authorized Post > Publish call, retain postSubmissionId.

2. Use Post > Get with that ID.

3. For in-progress, wait at least 10 seconds before another check within a bounded wait.

4. For scheduled, report the scheduled time rather than publication.

5. For published, return publicUrl if provided.

6. For failed, report errorMessage and follow publishing diagnosis.

If the installed node lacks Get, use an authenticated HTTP request to GET /v2/posts/{postSubmissionId}. An in-progress response is not a queue-health check. Do not repeat Publish because a status check failed.

Using Source Operations

Source creation and extraction are separate operations. Retain the returned ID and check the result before using its content.

Supported Source Types

Node choice	Input	Behavior
URL	A source URL	The node infers YouTube, TikTok, PDF, or audio from the URL and otherwise uses article.
Text	Text	Sends the text source type.
AI Research	Research query	Sends the perplexity-query source type.

These are the n8n node's choices, not the REST sourceType enum. For explicit type selection, including twitter, use the Create Source REST contract in an HTTP Request node. Inspect the request if URL inference chooses the wrong type.

Create Source

1. Add a Blotato node

2. Select Resource: "Source"

3. Select Operation: "Create"

4. Choose the source type

5. Provide the URL or text input

6. Execute the authorized extraction and retain the returned id.

Get Source

1. Add another Blotato node

2. Select Resource: "Source"

3. Select Operation: "Get"

4. Pass the resolution ID from the Create step

5. Execute and inspect status.

6. For queued or processing, wait at least 10 seconds before another Get within a bounded wait.

7. For completed, use the returned content.

8. For failed, stop and read message from the API result.

One Wait followed by Get does not guarantee completion. The node's _hint text is supplementary. Inspect the operation status and error fields. A Source result does not authorize a later generation or publication.

For full API details, see Create Source.

---

Troubleshooting

Template shows question marks instead of the Blotato logo?

1. Enable Verified Community Nodes first

2. Install the Blotato node

3. Re-import the n8n template

Need help?

Contact support by clicking the orange button in the bottom right corner within the Blotato app.