API Reference

import { Post2allClient } from "@post2all/sdk"

const client = new Post2allClient({
  apiKey: "amp_your_api_key",     // required
  baseUrl: "https://www.post2all.com/api/v1", // optional, this is the default
  fetchImplementation: fetch,      // optional, custom fetch for testing
})

const response = await client.listAccounts()

{
  accounts: {
    id: string
    platform: "twitter" | "linkedin" | "youtube" | "instagram" | "pinterest" | "threads"
    platformAccountId: string
    username: string | null
    displayName: string | null
    avatarUrl: string | null
    status: string
    supportedPostTypes: {
      text: boolean
      image: boolean
      video: boolean
    }
    createdAt: string
  }[]
}

const response = await client.createPost({
  type: "text",
  socialAccountIds: ["acc_123", "acc_456"],
  content: "Hello world",
  status: "scheduled",
  scheduledAt: "2026-06-20T09:00:00Z",
  mediaPaths: ["./photo.jpg"],
  accountSettings: {
    acc_123: { caption: "Custom caption" },
  },
})

{
  post: {
    id: string
    type: string
    content: string | null
    status: string
    scheduledAt: string | null
    createdAt: string
    mediaCount?: number
    accountCount?: number
  }
}

const response = await client.listPosts({
  page: 1,
  limit: 20,
  status: "published",
  type: "text",
})

{
  posts: {
    id: string
    type: string
    content: string | null
    status: string
    scheduledAt: string | null
    publishedAt: string | null
    createdAt: string
    accounts: {
      id: string | null
      platform: string
      username: string | null
      displayName: string | null
      disconnected: boolean
      status: string
      platformPostUrl: string | null
      error: string | null
    }[]
  }[]
  pagination: {
    page: number
    limit: number
    hasMore: boolean
  }
}

const response = await client.getPost("post_abc")

{
  post: {
    id: string
    type: string
    content: string | null
    media?: { type: string, path: string }[]
    status: string
    scheduledAt: string | null
    publishedAt: string | null
    createdAt: string
    updatedAt: string | null
    accounts: {
      id: string | null
      platform: string
      platformAccountId: string | null
      username: string | null
      displayName: string | null
      avatarUrl: string | null
      disconnected: boolean
      status: string
      platformPostId: string | null
      platformPostUrl: string | null
      error: string | null
      publishedAt: string | null
    }[]
  }
}

const response = await client.updatePost("post_abc", {
  content: "Updated content",
  scheduledAt: "2026-06-21T10:00:00Z",
})

{
  post: {
    id: string
    type: string
    content: string | null
    status: string
    scheduledAt: string | null
    publishedAt: string | null
    createdAt: string
    updatedAt: string | null
  }
}

const response = await client.deletePost("post_abc")

{ success: true }

const response = await client.cancelPost("post_abc")

{
  post: {
    id: string
    type: string
    content: string | null
    status: "draft"
    scheduledAt: string | null
    createdAt: string
    updatedAt: string | null
  }
}

import { Post2allApiError } from "@post2all/sdk"

try {
  await client.createPost({ ... })
} catch (error) {
  if (error instanceof Post2allApiError) {
    error.status   // HTTP status code
    error.code     // Error code (e.g., "INVALID_API_KEY")
    error.message  // Human-readable message
    error.details  // Raw API error body
  }
}

pnpm add -g @post2all/cli

# Authenticate
post2all config set-key amp_xxx

# List accounts
post2all accounts

# Create a post
post2all post create \
  --type text \
  --accounts acc_1,acc_2 \
  --content "Hello from CLI"

# List posts
post2all posts --status scheduled

# Cancel a scheduled post
post2all post cancel post_abc