Developer APIOverview

Firstage Developer API

With the Firstage API, you can programmatically manage content, automate social media publishing, and integrate workflows.

What You Can Do with the API

The Firstage API allows you to automate the following tasks:

  • Content Management: Create, update, and delete pages and content
  • Publishing Scheduler: Schedule and manage social media posts

Coming Soon: Stage management and AI prompt APIs are currently under development.

Before You Start

To use the API, you’ll need:

  1. Firstage Account: Sign up at app.firstage.ai
  2. Workspace: Create at least one workspace
  3. API Key: Generate an API key with workspace admin permissions

Quick Start

Step 1: Generate API Key

Go to the Developer Center in your dashboard to create an API key.

Dashboard → Developer → API Keys → Create New API Key

Step 2: Install SDK

npm install @seolhun/firstage-sdk

Step 3: Make Your First API Call

import { FirstageClient } from '@seolhun/firstage-sdk';
 
const client = new FirstageClient({
  apiKey: 'fak_your_api_key_here',
});
 
// Create content
const content = await client.contents.create({
  format: 'markdown',
  content: '# Hello World',
  title: 'My First Post',
});
 
console.log('Content created:', content.id);

Key Concepts

API Key

  • All API requests are authenticated with an API key
  • API keys are shown only once during creation, so store them securely
  • If a key is exposed, delete it immediately and generate a new one

Rate Limits

  • Default limit: 1,000 requests per hour
  • Returns 429 Too Many Requests when exceeded
  • Check remaining requests in response headers

Permissions

You can select the following permissions when creating an API key:

  • contents:read - Read content
  • contents:write - Create/update content
  • schedules:read - Read schedules
  • schedules:write - Create/update schedules

Security Best Practices

API Key Management

✅ Recommended:

  • Store API keys in environment variables
  • Use separate keys for each environment (dev/production)
  • Rotate keys regularly

❌ Don’t:

  • Hard-code API keys in source code
  • Commit keys to public repositories
  • Use one key for multiple purposes

Environment Variables

# .env file
FIRSTAGE_API_KEY=fak_your_api_key_here
// Use in code
const client = new FirstageClient({
  apiKey: process.env.FIRSTAGE_API_KEY,
});

Next Steps

Support

Have questions or issues?

CRM and Customer Management (Coming Soon)Quick Start