PostZen Node.js SDK

import PostZen from '@postzen/node';

const postzen = new PostZen();

const { data } = await postzen.posts.createPost({
  body: {
    title: 'Launch post',
    content: 'We shipped the new release.',
    publishNow: true,
    platforms: [
      {
        platform: 'twitter',
        accountId: 'account_id',
      },
    ],
  },
});

if (data && 'post' in data) {
  console.log(`Created post ${data.post._id}`);
}

import PostZen from '@postzen/node';

// Explicit key
const postzen = new PostZen({ apiKey: 'pzn_live_...' });

// Or rely on POSTZEN_API_KEY in the environment
const fromEnv = new PostZen();

import PostZen from '@postzen/node';

const postzen = new PostZen({
  apiKey: 'pzn_live_...',
  baseURL: 'https://api.postzen.dev',
  timeout: 60000,
  defaultHeaders: {
    'X-Request-Source': 'my-app',
  },
});

const { data } = await postzen.profiles.createProfile({
  body: {
    name: 'Marketing Team',
    description: 'Profile for marketing campaigns',
    color: '#4caf50',
  },
});

console.log(data.profile._id);

const profileId = 'profile_id';

const { data: start } = await postzen.connect.createConnectUrl({
  path: {
    platform: 'linkedin',
  },
  query: {
    profileId,
    redirectUrl: 'https://yourapp.example/connected',
  },
});

console.log(start.authUrl);

await postzen.connect.completeConnect({
  path: {
    platform: 'linkedin',
  },
  body: {
    code: 'oauth_code_from_redirect',
    state: start.state,
    profileId,
  },
});

const file = await fetch('https://example.com/image.png').then((response) => response.blob());

const { data: presign } = await postzen.media.createMediaPresign({
  body: {
    filename: 'image.png',
    contentType: 'image/png',
    size: file.size,
  },
});

await fetch(presign.uploadUrl, {
  method: 'PUT',
  headers: {
    'Content-Type': 'image/png',
  },
  body: file,
});

await postzen.posts.createPost({
  body: {
    title: 'Post with media',
    content: 'Uploaded through a PostZen presigned URL.',
    publishNow: true,
    mediaItems: [
      {
        url: presign.publicUrl,
        title: 'image.png',
      },
    ],
    platforms: [
      {
        platform: 'instagram',
        accountId: 'account_id',
      },
    ],
  },
});

// From a file path — content type inferred from the extension.
const media = await postzen.media.upload('./photo.jpg');

// From a Buffer or Uint8Array — filename is required.
const fromBytes = await postzen.media.upload(buffer, { filename: 'photo.jpg' });

// media => { publicUrl, key, type, size, filename }
console.log(media.publicUrl);

const media = await postzen.media.upload('./photo.jpg');

await postzen.posts.createPost({
  body: {
    title: 'Post with media',
    content: 'Uploaded through the PostZen SDK.',
    publishNow: true,
    mediaItems: [{ url: media.publicUrl, title: media.filename }],
    platforms: [{ platform: 'instagram', accountId: 'account_id' }],
  },
});

const { data } = await postzen.accounts.listAccounts({
  query: {
    status: 'connected',
    platform: 'linkedin',
  },
});

for (const account of data.accounts) {
  console.log(`${account.platform}: ${account.displayName}`);
}

let page = 1;
let totalPages = 1;

do {
  const { data } = await postzen.accounts.listAccounts({
    query: { page, limit: 50 },
  });

  for (const account of data.accounts) {
    console.log(`${account.platform}: ${account.displayName}`);
  }

  totalPages = data.pagination?.totalPages ?? 1;
  page += 1;
} while (page <= totalPages);

import PostZen, { PostZenApiError, RateLimitError, ValidationError } from '@postzen/node';

const postzen = new PostZen();

try {
  await postzen.posts.createPost({
    body: {
      content: 'Hello from PostZen',
      publishNow: true,
      platforms: [{ platform: 'twitter', accountId: 'account_id' }],
    },
  });
} catch (error) {
  if (error instanceof RateLimitError) {
    console.error(`Rate limited. Retry in ${error.getSecondsUntilReset()} seconds.`);
  } else if (error instanceof ValidationError) {
    console.error('Validation failed:', error.fields);
  } else if (error instanceof PostZenApiError) {
    console.error(`PostZen API error ${error.statusCode}: ${error.message}`);
  } else {
    throw error;
  }
}