Node.js SDK - PostlyBee

The postlybee package wraps the core posts, media, and connected-account endpoints. The constructor accepts the raw workspace API key and adds the Bearer prefix automatically.

Install

npm install postlybee

Initialize

import Postlybee from 'postlybee';

const client = new Postlybee(process.env.POSTLYBEE_API_KEY!);

Self-hosted installations can pass a custom backend origin as the second argument:

const client = new Postlybee(
  process.env.POSTLYBEE_API_KEY!,
  'https://api.example.com'
);

Available methods

Method	Description
`post(payload)`	Create drafts, scheduled posts, or immediate posts.
`postList(filters)`	List posts within a UTC date range.
`upload(file, extension)`	Upload an image buffer.
`integrations()`	List connected social accounts.
`deletePost(id)`	Delete a root post and its group.

Schedule a post

const accounts = await client.integrations();

const result = await client.post({
  type: 'schedule',
  date: '2030-01-15T09:00:00.000Z',
  shortLink: false,
  tags: [],
  posts: [
    {
      integration: { id: accounts[0].id },
      value: [{ content: 'Scheduled from Node.js', image: [] }],
      settings: {},
    },
  ],
});

Use the SDK from trusted server-side code. Do not bundle a workspace API key into a browser or mobile application.

Last modified on August 26, 2026

⌘I