Quickstart

Get Started with Blotato API

The Blotato API is a social media API that allows you to publish and schedule posts directly to platforms. You can post any content, such as text, images, and videos.

It is limited to paying subscribers in order to reduce spam and service abuse, keeping Blotato's integration in good standing with the social platforms.

---

✅ Official n8n and Make.com Nodes for Blotato!

Blotato has an official Make.com module. Simply add a new module and search Blotato.

Blotato has an official n8n community node. Your n8n instance must have "community nodes" enabled.

---

Get Your API Key

Go to Settings > API > click "Generate API Key".

❗IMPORTANT: this will end your free trial immediately and start your paid subscription.

---

Connect Social Accounts

Go to Settings and connect your social accounts.

You will need the Account ID and Page ID of your social accounts in order to post to them via API.

More information here:

Social accounts | Blotato Help

---

Get Started with n8n or Make

Check out these tutorials and templates to get started with the API basics:

n8n Tutorial: https://help.blotato.com/api/n8n/n8n-basics

Make.com Tutorial: https://help.blotato.com/api/make.com/make-basics

---

How to Troubleshoot Errors

Use the API Dashboard and click on each request to see full payload, response, and error message:

API Dashboard (for debugging): https://my.blotato.com/api-dashboard

For common error solutions, check the API FAQs.

---

Authentication

To authenticate API requests, include your Blotato API key in the request headers.

Authentication Header

blotato-api-key: YOUR_API_KEY

Requests without a valid API key will be rejected and 401 error will be returned.

---

Raw API Calls - Examples

Post to a Platform Immediately

POST https://backend.blotato.com/v2/posts HTTP/1.1
Content-Type: application/json
Headers:

{
  "post": {
    "accountId": "acc_12345",
    "content": {
      "text": "Hello, world!",
      "mediaUrls": [],
      "platform": "twitter"
    },
    "target": {
      "targetType": "twitter"
    }
  }
}

Post at a Scheduled Time

POST https://backend.blotato.com/v2/posts HTTP/1.1
Content-Type: application/json

{
  "post": {
    "accountId": "acc_67890",
    "content": {
      "text": "Scheduled post example",
      "mediaUrls": [],
      "platform": "facebook"
    },
    "target": {
      "targetType": "facebook",
      "pageId": "987654321"
    }
  },
  "scheduledTime": "2025-03-10T15:30:00Z"
}

Post a Twitter Thread with Multiple Posts

POST https://backend.blotato.com/v2/posts HTTP/1.1
Content-Type: application/json

{
  "post": {
    "accountId": "acc_13579",
    "content": {
      "text": "This is the first tweet in the thread.",
      "mediaUrls": [],
      "platform": "twitter",
      "additionalPosts": [
        {
          "text": "Here's the second tweet, adding more info.",
          "mediaUrls": []
        },
        {
          "text": "And here's the third tweet to conclude!",
          "mediaUrls": []
        }
      ]
    },
    "target": {
      "targetType": "twitter"
    }
  }
}

Attach Media to Post (images and videos)

If your post has images or videos, you need to first upload the media to Blotato's servers. Most social platforms will reject your request to post random image/video URLs.

1. Upload media:

POST https://backend.blotato.com/v2/media HTTP/1.1
Content-Type: application/json

{
  "url": "https://example.com/image.jpg"
}

1. Response:

{
  "url": "https://database.blotato.com/d1655c49-0bc4-4dd0-88b2-323ce0069fa4.jpg"
}

1. Grab the URL from the response, then pass it in your Publish request:

POST https://backend.blotato.com/v2/posts HTTP/1.1
Content-Type: application/json

{
  "post": {
    "accountId": "acc_24680",
    "content": {
      "text": "Check out this image!",
      "mediaUrls": [
        "https://database.blotato.com/d1655c49-0bc4-4dd0-88b2-323ce0069fa4.jpg",
      ],
      "platform": "instagram"
    },
    "target": {
      "targetType": "instagram"
    }
  }
}

---

Next Steps

Check out these additional guides:

Make.com Example

n8n Example

API Reference