Get started with the SDK

npm install @medalsocial/sdk
# or
pnpm add @medalsocial/sdk

import { Medal } from '@medalsocial/sdk';

// API keys are prefixed medal_ and scoped to one workspace —
// create one under Settings → API keys.
const medal = new Medal(process.env.MEDAL_API_KEY as string);

// Your first call: which channels can this workspace post to?
const { data: channels } = await medal.posts.channels();
console.log(channels.map((c) => c.platform));

// Create and schedule a post
const { data: post } = await medal.posts.create({
  content: 'Hello from the Medal Social SDK!',
  channel_ids: [channels[0].id],
});
await medal.posts.schedule(post.id, { scheduled_at: '2026-08-01T09:00:00Z' });