TypeScript SDK

npm install @autoposting.ai/sdk@latest

import { Autoposting } from '@autoposting.ai/sdk'

const client = new Autoposting({ apiKey: 'sk-social-...' })

// Create and publish a post
const post = await client.posts.create({
  brandSlug: 'my-brand',
  text: 'Hello from the SDK!',
  platforms: ['x', 'linkedin'],
})

await client.posts.publish(post.id)

const client = new Autoposting({
  apiKey: 'sk-social-...',          // required
  baseUrl: 'https://app.autoposting.ai/api-proxy', // optional — this is the default (the /api-proxy path; the bare host serves the dashboard, not the API)
  timeout: 30000,                   // optional — request timeout in ms
})

const posts = await client.posts.list({ status: 'scheduled' })

const post = await client.posts.create({
  brandSlug: 'my-brand',
  text: 'Check out our latest blog post!',
  platforms: ['x', 'linkedin', 'threads'],
  scheduledAt: '2026-02-01T14:00:00Z',
})

// AI-rewrite for better engagement
await client.posts.rewrite(post.id)

// Get AI score and feedback
const score = await client.posts.score(post.id)

const agent = await client.agents.create({
  name: 'Daily Tech News',
  type: 'publish',
  brandSlug: 'my-brand',
  prompt: 'Write a short post about the latest AI news',
  frequency: 'daily',
  time: '09:00',
})

await client.agents.run(agent.id)
const runs = await client.agents.runs(agent.id)

const kb = await client.kb.create({ name: 'Product Docs' })
await client.kb.ingestUrl(kb.id, 'https://docs.example.com')
const results = await client.kb.search(kb.id, 'pricing')

const carousel = await client.carousels.generate({
  topic: '5 Tips for Social Media Growth',
  brandSlug: 'my-brand',
  slideCount: 5,
})

await client.carousels.draft(carousel.id)

const webhook = await client.webhooks.create({
  url: 'https://api.example.com/webhook',
  events: ['post.published', 'post.failed'],
})

await client.webhooks.test(webhook.id)

import {
  AutopostingError,     // base class
  AuthenticationError,  // 401 — invalid API key
  ScopeError,           // 403 — insufficient API key scopes
  NotFoundError,        // 404 — resource not found
  ValidationError,      // 400/422 — invalid input
  RateLimitError,       // 429 — rate limited
  ServerError,          // 5xx — server error
} from '@autoposting.ai/sdk'

try {
  await client.posts.getById('nonexistent')
} catch (err) {
  if (err instanceof NotFoundError) {
    console.log('Post not found:', err.message)
  }
  if (err instanceof RateLimitError) {
    console.log('Rate limited, retry after:', err.message)
  }
}

--api-key flag  >  AUTOPOSTING_API_KEY env  >  stored credentials