The Medal platform, in your codebase.

From install to first call in five minutes

bashInstallcopy
npm i @medalsocial/sdk
# or
pnpm add @medalsocial/sdk

tsYour first callscopy
import { Medal } from '@medalsocial/sdk';

const apiKey = process.env.MEDAL_API_KEY;
if (!apiKey) throw new Error('Set MEDAL_API_KEY to a workspace API key (medal_…)');
const medal = new Medal(apiKey);

// Which channels can this workspace post to?
const { data: channels } = await medal.posts.channels();
const [channel] = channels;
if (!channel) throw new Error('Connect a channel in the Medal app first');

const { data: post } = await medal.posts.create({
  content: 'Hello from the Medal SDK!',
  channel_ids: [channel.id],
});
const tomorrow = new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString();
await medal.posts.schedule(post.id, { scheduled_at: tomorrow });

await medal.emails.send({
  template_slug: 'welcome',
  to: 'user@example.com',
  variables: { name: 'Ida' },
});

const { data: contact } = await medal.contacts.create({
  email: 'ida@example.com',
  first_name: 'Ida',
  status: 'lead',
});