← Back to Skills Marketplace
🔌

dopost-api

by dopost · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ✓ Security Clean
117
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install dopost
Description
Use the Dopost REST API to publish, schedule, and manage social media posts programmatically. Use this skill when the user wants to publish to social media,...
README (SKILL.md)

Dopost API

Dopost is a social media management platform. Its REST API lets you publish and schedule posts, manage media, and inspect connected social accounts.

Base URL: https://dopost.co/api/v1
Auth: All requests require the header x-api-key: \x3Cyour-key>
Full docs: https://dopost.co/docs/api

Setup

Always check for an .env or .env.local file with DOPOST_API_KEY. If not present, ask the user for their key before proceeding.

export DOPOST_API_KEY="dpk_live_..."

Endpoints

Social Accounts

List connected accounts

GET /api/v1/social/accounts
Scope: social:accounts

curl -H "x-api-key: $DOPOST_API_KEY" https://dopost.co/api/v1/social/accounts

Returns { accounts: [{ id, platform, platformUsername, platformUserId }] }.
The id field is the accountId needed for publishing.

Get platform limits

GET /api/v1/social/limits/:platform
Scope: social:limits

Platforms: x, instagram, instagram_direct, facebook, linkedin, linkedin_organization, tiktok, youtube, threads, bluesky, mastodon, pinterest

instagram = connected via Meta Business (Facebook Page linked). instagram_direct = connected directly via Instagram OAuth.
linkedin = personal profile. linkedin_organization = company page.

curl -H "x-api-key: $DOPOST_API_KEY" https://dopost.co/api/v1/social/limits/instagram

Posts

Publish or schedule a post

POST /api/v1/post/publish
Scope: posts:create

{
  "accountId": "\x3CaccountId>",
  "text": "Post content",
  "media": ["https://..."],
  "publishAt": "2025-12-25T12:00:00Z",
  "platformOptions": {}
}
  • At least text or media is required
  • media can be an array of URL strings or objects { url: "..." }
  • Maximum 10 media items per post
  • Omit publishAt (or set to null) to publish immediately
  • Returns 202 with { success, jobId, postId, status }
  • Publishing is asynchronous — poll GET /api/v1/post/:postId to check status
Platform-specific options (platformOptions)

Instagram

Field Values Default
postType "feed" | "story" | "reel" "feed" (auto "carousel" with multiple media)

TikTok

Field Values Default
privacyLevel "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY" "PUBLIC_TO_EVERYONE"
disableDuet boolean false
disableStitch boolean false
disableComment boolean false

YouTube

Field Values Default
videoType "video" | "short" "video"
title string First 100 chars of text
privacyStatus "public" | "private" | "unlisted" "public"

Pinterest

Field Description
board Board ID (required for Pinterest)

Get a post

GET /api/v1/post/:postId
Scope: posts:read

Returns the full post object including publish status:

{
  "id": "cm3abc123def456",
  "status": "PUBLISHED",
  "platform": "INSTAGRAM",
  "text": "Post content",
  "media": [],
  "postUrl": "https://instagram.com/p/...",
  "account": {
    "id": "cm3xyz789ghi012",
    "platform": "INSTAGRAM",
    "platformUsername": "myaccount"
  },
  "schedule": {
    "scheduledFor": "2026-04-13T09:00:00.000Z",
    "status": "PUBLISHED",
    "publishedAt": "2026-04-13T09:00:05.000Z"
  },
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "source": "api",
  "createdAt": "2026-04-07T10:00:00.000Z",
  "updatedAt": "2026-04-07T10:32:18.000Z"
}

schedule is null for immediate posts. postUrl is null until published.
Use this endpoint to poll status after publishing.

List posts

GET /api/v1/post?status=PENDING&limit=20&cursor=\x3Ccursor>
Scope: posts:read

Status filter values: DRAFT, PENDING, PUBLISHED, FAILED

Reschedule a post

PATCH /api/v1/post/:postId
Scope: posts:reschedule
Body: { "publishAt": "2025-12-31T09:00:00Z" }

Only works on posts with status PENDING. The new date must be in the future.
Returns { id, scheduledFor }.

Delete a post

DELETE /api/v1/post/delete/:postId
Scope: posts:delete

Cancels scheduling automatically if the post is PENDING.
Returns { success: true, deletedPostId: "..." }.

Media

Upload media (presigned URL flow)

POST /api/v1/media
Scope: media:upload
Body: { "fileName": "photo.jpg", "contentType": "image/jpeg", "sizeInBytes": 204800 }

Returns 201 with:

{
  "id": "cm3media001xyz",
  "uploadUrl": "https://storage.example.com/...?X-Amz-Signature=...",
  "publicUrl": "https://cdn.dopost.co/media/.../photo.jpg",
  "fileName": "photo.jpg",
  "contentType": "image/jpeg",
  "expiresIn": 3600
}
  • uploadUrl is a temporary presigned URL — upload the file with a PUT request within expiresIn seconds
  • publicUrl is the permanent URL — use this as the media URL when publishing
  • Maximum file size: 1 GB
curl -X PUT -H "Content-Type: image/jpeg" --data-binary @photo.jpg "$UPLOAD_URL"

List media

GET /api/v1/media?limit=20&cursor=\x3Ccursor>
Scope: media:list

Delete media

DELETE /api/v1/media/:mediaId
Scope: media:delete

Returns { message: "Media deleted", mediaId: "..." }.

Common workflows

Publish a post now

  1. GET /api/v1/social/accounts — pick accountId
  2. POST /api/v1/post/publish with accountId + text
  3. GET /api/v1/post/:postId — poll until status is PUBLISHED or FAILED

Publish a post with an image

  1. POST /api/v1/media — get uploadUrl + publicUrl
  2. PUT the file to uploadUrl
  3. POST /api/v1/post/publish with media: [publicUrl]
  4. GET /api/v1/post/:postId — poll until published

Schedule and reschedule

  1. Publish with a future publishAt
  2. To change the date: PATCH /api/v1/post/:postId with new publishAt
  3. To cancel: DELETE /api/v1/post/delete/:postId

Error handling

Status Meaning
400 Bad request — check the request body
401 Invalid or missing x-api-key
403 API key lacks the required scope
404 Resource not found or inactive account
429 Rate limit or monthly quota exceeded. Check X-RateLimit-* headers

On 429, respect the Retry-After header before retrying.

Examples

1. List connected accounts

Request

curl -H "x-api-key: $DOPOST_API_KEY" \
  https://dopost.co/api/v1/social/accounts

Response 200 OK

{
  "accounts": [
    {
      "id": "cm3xyz789ghi012",
      "platform": "INSTAGRAM",
      "platformUsername": "myaccount",
      "platformUserId": "17841400000000001"
    },
    {
      "id": "cm3abc456def789",
      "platform": "LINKEDIN",
      "platformUsername": "johndoe",
      "platformUserId": "urn:li:person:a1B2c3D4e5"
    }
  ]
}

2. Publish a text post immediately

Request

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "cm3xyz789ghi012",
    "text": "Hello from the Dopost API!"
  }' \
  https://dopost.co/api/v1/post/publish

Response 202 Accepted

{
  "success": true,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "postId": "cm3abc123def456",
  "status": "processing"
}

3. Check post status

Request

curl -H "x-api-key: $DOPOST_API_KEY" \
  https://dopost.co/api/v1/post/cm3abc123def456

Response — published

{
  "id": "cm3abc123def456",
  "status": "PUBLISHED",
  "platform": "INSTAGRAM",
  "text": "Hello from the Dopost API!",
  "media": [],
  "postUrl": "https://www.instagram.com/p/ABC123/",
  "account": {
    "id": "cm3xyz789ghi012",
    "platform": "INSTAGRAM",
    "platformUsername": "myaccount"
  },
  "schedule": null,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "source": "api",
  "createdAt": "2026-04-07T10:00:00.000Z",
  "updatedAt": "2026-04-07T10:32:18.000Z"
}

Response — failed

{
  "id": "cm3abc123def456",
  "status": "FAILED",
  "platform": "INSTAGRAM",
  "text": "Hello from the Dopost API!",
  "media": [],
  "postUrl": null,
  "account": {
    "id": "cm3xyz789ghi012",
    "platform": "INSTAGRAM",
    "platformUsername": "myaccount"
  },
  "schedule": null,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "source": "api",
  "createdAt": "2026-04-07T10:00:00.000Z",
  "updatedAt": "2026-04-07T10:05:00.000Z"
}

4. Publish an Instagram Reel

Request

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "cm3xyz789ghi012",
    "text": "New reel! #content",
    "media": ["https://cdn.example.com/video.mp4"],
    "platformOptions": {
      "postType": "reel"
    }
  }' \
  https://dopost.co/api/v1/post/publish

Response 202 Accepted

{
  "success": true,
  "jobId": "a1b2c3d4-0000-4abc-8def-111122223333",
  "postId": "cm3reel001xyz",
  "status": "processing"
}

5. Schedule a post

Request

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "cm3abc456def789",
    "text": "Scheduled post for next Monday!",
    "publishAt": "2026-04-13T09:00:00Z"
  }' \
  https://dopost.co/api/v1/post/publish

Response 202 Accepted

{
  "success": true,
  "jobId": "b2c3d4e5-1111-4bcd-9ef0-222233334444",
  "postId": "cm3sched001abc",
  "status": "scheduled"
}

6. Upload media and publish with it

Step 1 — Request presigned URL

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileName": "photo.jpg",
    "contentType": "image/jpeg",
    "sizeInBytes": 204800
  }' \
  https://dopost.co/api/v1/media

Response 201 Created

{
  "id": "cm3media001xyz",
  "uploadUrl": "https://storage.example.com/uploads/photo.jpg?X-Amz-Signature=...",
  "publicUrl": "https://cdn.dopost.co/media/cm3media001xyz/photo.jpg",
  "fileName": "photo.jpg",
  "contentType": "image/jpeg",
  "expiresIn": 3600
}

Step 2 — Upload the file

curl -X PUT \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg \
  "https://storage.example.com/uploads/photo.jpg?X-Amz-Signature=..."

Returns 200 with empty body on success.

Step 3 — Publish using the public URL

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "cm3xyz789ghi012",
    "text": "Check out this photo!",
    "media": ["https://cdn.dopost.co/media/cm3media001xyz/photo.jpg"]
  }' \
  https://dopost.co/api/v1/post/publish

7. Reschedule a pending post

Request

curl -X PATCH \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "publishAt": "2026-04-20T14:00:00Z" }' \
  https://dopost.co/api/v1/post/cm3sched001abc

Response 200 OK

{
  "id": "cm3sched001abc",
  "scheduledFor": "2026-04-20T14:00:00.000Z"
}

8. List posts with filter

Request

curl -H "x-api-key: $DOPOST_API_KEY" \
  "https://dopost.co/api/v1/post?status=PUBLISHED&limit=5"

Response 200 OK

{
  "posts": [
    {
      "id": "cm3abc123def456",
      "status": "PUBLISHED",
      "text": "Hello from the Dopost API!",
      "publishedAt": "2026-04-07T10:32:18.000Z",
      "account": {
        "id": "cm3xyz789ghi012",
        "platform": "INSTAGRAM",
        "platformUsername": "myaccount"
      }
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

9. Delete a post

Request

curl -X DELETE \
  -H "x-api-key: $DOPOST_API_KEY" \
  https://dopost.co/api/v1/post/delete/cm3sched001abc

Response 200 OK

{
  "success": true,
  "deletedPostId": "cm3sched001abc"
}

MCP server (optional)

If the user has the Dopost MCP server configured, prefer using MCP tools (publish_post, list_accounts, etc.) over raw HTTP calls — they handle auth and path safety automatically.

MCP setup: https://dopost.co/docs/api

Usage Guidance
This skill will use your Dopost API key (DOPOST_API_KEY) to call Dopost endpoints and publish or schedule posts. Only install it if you trust the Dopost integration and the skill source. Prefer creating a scoped API key with minimal permissions rather than a full account master key, and rotate or revoke the key if you stop using the skill. Confirm the API key is stored securely (not committed to public repos) and review Dopost's official docs (https://dopost.co/docs/api) if you need to verify endpoint behavior. Note: the skill can be invoked by an agent per platform defaults — ensure you are comfortable with the agent performing publishing actions on your behalf.
Capability Analysis
Type: OpenClaw Skill Name: dopost Version: 1.1.0 The skill bundle provides standard documentation and instructions for interacting with the Dopost REST API for social media management. It includes clear API endpoint definitions, authentication requirements via environment variables, and typical curl examples for publishing and managing posts without any signs of malicious intent or data exfiltration (SKILL.md).
Capability Tags
requires-oauth-token
Capability Assessment
✓ Purpose & Capability
Name/description, documented endpoints, and required DOPOST_API_KEY align. All declared capabilities (publish, schedule, media upload, account listing) map directly to the API endpoints documented in SKILL.md.
✓ Instruction Scope
SKILL.md limits runtime actions to preparing HTTP requests to dopost.co endpoints and instructs checking for a DOPOST_API_KEY in .env or asking the user. It does not ask to read unrelated files, access other credentials, or send data to unexpected endpoints.
✓ Install Mechanism
Instruction-only skill with no install spec and no code files — nothing is written to disk or downloaded. This is the lowest-risk install model and fits the skill's purpose.
✓ Credentials
Only a single env var (DOPOST_API_KEY) is required and is appropriate for the documented REST API usage. The SKILL.md references only that key for authentication; no unrelated secrets or system paths are requested.
✓ Persistence & Privilege
The skill is not always-enabled (always: false) and does not request persistent system-wide configuration. It uses the platform-default autonomous invocation capability, which is standard for skills and not excessive here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install dopost
  3. After installation, invoke the skill by name or use /dopost
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
dopost-api v1.1.0 - Adds detailed SKILL.md documentation covering all major Dopost REST API endpoints, authentication, required environment variables, and usage workflows. - Includes endpoint references for social account management, publishing, scheduling, media upload, and error handling. - Specifies when to activate the skill, including explicit user intents and keyword triggers. - Outlines setup instructions and platform-specific options for publishing and scheduling posts. - Provides example requests and responses for common use cases.
Metadata
Slug dopost
Version 1.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is dopost-api?

Use the Dopost REST API to publish, schedule, and manage social media posts programmatically. Use this skill when the user wants to publish to social media,... It is an AI Agent Skill for Claude Code / OpenClaw, with 117 downloads so far.

How do I install dopost-api?

Run "/install dopost" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is dopost-api free?

Yes, dopost-api is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does dopost-api support?

dopost-api is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created dopost-api?

It is built and maintained by dopost (@dopost); the current version is v1.1.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments