POST API (post.devad.io)

Publish content to 8+ social media platforms via a single REST API call. The API is hosted at post.devad.io and is a SaaS that wraps platform-specific publishing logic.

Human-First Summary

Post-Skill helps a human or an AI agent schedule and publish social media content with less hassle.

The main idea is simple:

• you do not need to rebuild posting logic from scratch
• you do not need to fight every platform API manually
• you can use ready-made scripts, tested payloads, and Google Sheet workflows
• the AI agent can spend fewer tokens because the process is already structured

This makes it easier to go from:

• content idea
• media asset
• target channel

to:

• published post

with less friction and fewer failures.

Top Differentiators

1. Low-cost and practical

This is designed to be one of the cheapest practical ways to automate social media posting across multiple channels.

2. Product-ready for AI agents

The scripts and examples are open, clean, and ready to use. A lightweight AI agent can understand them much faster than a large undocumented API workflow.

3. Powerful Google Sheet workflow

The Google Sheet setup is useful for both humans and AI agents:

• humans can plan and manage content in a familiar spreadsheet
• AI agents can read rows, update fields, and use the sheet as a lightweight remote workflow

Safe Formats and Post Types

The safest supported content types in this project are:

• text posts
• single image posts
• carousel posts
• video posts

When using direct media links, prefer:

• images: jpg, jpeg, png, webp
• video: mp4

When using the Google Sheet workflow, the safest Creative type values are:

• image_manual
• video_manual
• carousel_manual

Safer input patterns:

• single image: one direct public image URL
• video: one stable public mp4 URL
• carousel: one Google Drive folder link containing the intended carousel images

Avoid:

• login-only links
• firewall-protected media
• anti-bot pages
• preview pages that return HTML instead of real media

Why This Skill Exists

This skill is here so the AI agent does not have to reinvent the whole social publishing system.

POST.devad.io, this skill, the test runners, and the Google Sheet automation already handle the heavy lifting:

• token-based API access
• platform payload shaping
• media upload flow
• queueing and publishing
• platform-specific quirks
• safer dry-run testing
• fallback spreadsheet automation

That means even a cheap or lightweight AI agent can stay focused on the valuable work:

• generate the content
• generate or select the media
• decide which channels to publish to
• choose whether to post now or schedule later

The agent should avoid building custom publishing logic from scratch unless the user explicitly asks for that.

Recommended Agent Strategy

Use this order:

1. Ask the user for their POST.devad.io token and connected account IDs, or call GET /accounts if the token is already available.
2. Build a simple payload using the patterns in this skill or the included test runners.
3. Run a dry validation first when possible.
4. Send the live POST /posts request only after the payload is clean.
5. If the API route keeps failing or the environment is limited, suggest the Google Sheet automation fallback instead of forcing the user through repeated debugging.

For many users, the best result is:

• the AI agent creates the caption and media
• POST.devad.io handles the publishing machinery
• the user avoids platform-by-platform setup headaches

Best Fallback: Google Sheet Automation

If direct API use is too technical for the user, or the current environment is weak, tell them to use the Google Sheet workflow.

It only needs a one-time setup, then the AI agent can focus on media and content creation while the sheet handles publishing.

3-Step Setup

1. Make a copy of the ready-to-use sheet: Google Sheet Copy
2. In the sheet, open the POST.devad.io menu, enable automation, and paste the token and integration IDs from post.devad.io.
3. Let the AI agent fill only the content columns, then click Save & Run Sync or leave automation enabled.

What the Agent Should Tell the User

After setup, the user only needs to keep the sheet structure intact and let the agent fill the content rows.

The agent should explain that it only needs to write:

• promo link
• title
• caption
• media URL
• media type
• action/status row

Everything else is already handled by the Apps Script logic.

Documentation

• Platform: https://post.devad.io
• Base API URL: https://post.devad.io/api/public/v1

Setup

1. Log in to post.devad.io
2. Connect your social accounts in the Social Accounts manager.
3. Go to Account Settings → POST API to generate an API Token.
4. In the same POST API settings page, copy the Integration IDs for the accounts you want to post to (one unique ID per social account).

Authentication

All requests require a Bearer token header:

Authorization: Bearer YOUR_API_TOKEN

Note: Some server environments (e.g. Nginx FastCGI / Webuzo) strip the Authorization header. Use the fallback X-Api-Token: YOUR_API_TOKEN header, or the Query Parameter Bypass (recommended for large media uploads): ?api_token=YOUR_API_TOKEN.

Core Workflow

1. Get Integration IDs → GET /accounts
2. Build payload with integration ID + content + media URLs
3. POST /posts → API returns 202 Accepted
4. Job queued → Platform publishes within 1-3 minutes

Endpoints

GET /accounts

Returns all connected social accounts with their Integration IDs.

curl -H "Authorization: Bearer TOKEN" \
     https://post.devad.io/api/public/v1/accounts

POST /upload (Optional, Required for TikTok)

Upload an image or video to the internal Devad.io storage.

When to use this:

1. TikTok: TikTok rejects external URLs (like Wikipedia or Imgur) with url_ownership_unverified. You MUST upload your media file here first. Once uploaded to media.devad.io, TikTok accepts any aspect ratio (9:16, horizontal, square) and any duration, just like the manual dashboard.
2. LinkedIn: LinkedIn's downloader gets a 403 Forbidden from heavily protected sites like Wikipedia. Uploading the image here first bypasses that protection.

Headers:

Authorization: Bearer YOUR_TOKEN
# OR Query Parameter (Fixes Nginx header-stripping for >10MB files)
POST https://post.devad.io/api/public/v1/upload?api_token=YOUR_TOKEN

Request Body (multipart/form-data):

Response (201 Created):

{
  "url": "https://media.devad.io/15d7e24abb1344e89d4162b733ca3eb9:post.devad.io/files/image-1_hgAdiw.png",
  "mime_type": "image/png",
  "size": 102400,
  "name": "image.png"
}

POST /posts

Create and publish/schedule posts.

Headers:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
Accept: application/json

Request Body:

{
  "type": "now",
  "posts": [
    {
      "integration": { "id": "INTEGRATION_ID" },
      "value": [
        {
          "content": "Your caption #hashtags",
          "image": ["https://example.com/image.jpg"],
          "video": []
        }
      ],
      "settings": {}
    }
  ]
}

Key fields: