Skip to main content

Getting Started

Welcome to the Flow API! This guide will help you get started with scheduling and managing social media posts programmatically.

What is Flow?โ€‹

Flow is a social media publishing API that lets you post to multiple platforms with a single API call. Think of it as "Resend for social media posting."

Quick Exampleโ€‹

import { Flow } from '@flowdev/sdk';

const flow = new Flow('flow_sk_live_...');

// Create a post
const post = await flow.posts.create({
channelId: 'channel_123',
content: 'Hello from Flow! ๐Ÿš€',
scheduledFor: new Date('2024-12-25T10:00:00Z'),
});

console.log('Post created:', post.id);

Prerequisitesโ€‹

Before you begin, make sure you have:

  1. A Flow account - Sign up if you don't have one
  2. An API key - Create one in Settings โ†’ API Keys
  3. A development environment - Node.js 18+, Python 3.8+, or Go 1.21+

Installationโ€‹

TypeScript/JavaScriptโ€‹

npm install @flowdev/sdk

Pythonโ€‹

pip install flow-sdk

Goโ€‹

go get github.com/flowdev/go-sdk

Your First API Callโ€‹

  1. Get your API key from the dashboard
  2. Create a channel (or use an existing one)
  3. Create a post using the code above

Core Conceptsโ€‹

Channelsโ€‹

Channels are containers for organizing your posts. Each channel can have multiple platform connections.

See Connections Guide for details.

Postsโ€‹

Posts are the content you want to publish. They can be scheduled for the future or posted immediately.

Connectionsโ€‹

Connections link your social media accounts to Flow. Connect Twitter, LinkedIn, Instagram, Facebook, or TikTok.

Next Stepsโ€‹

Need Help?โ€‹