Getting Started

Chirpie is a social media API for AI agents and developers. Post to X/Twitter via API, CLI, MCP, or SDK — with scheduling, analytics, and multi-account support.

Quick Start

1. Create an account

2. Connect your X account

Follow the onboarding to connect your X (Twitter) account via OAuth. This authorizes Chirpie to post on your behalf.

3. Get your API key

Create an API key from the dashboard or during onboarding. Keys start with chirpie_sk_ and are shown once — save it somewhere safe.

4. Send your first post

curl -X POST https://chirpie.ai/api/v1/posts \
  -H "Authorization: Bearer chirpie_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "YOUR_ACCOUNT_ID",
    "text": "Hello from Chirpie! 🐦"
  }'

import { ChirpieClient } from "@chirpie/sdk";

const chirpie = new ChirpieClient({ apiKey: "chirpie_sk_YOUR_KEY" });

const post = await chirpie.createPost({
  account_id: "YOUR_ACCOUNT_ID",
  text: "Hello from Chirpie! 🐦",
});

console.log(post.id, post.status);

# First, authenticate
chirpie login

# Post (auto-selects account if you only have one)
chirpie post "Hello from Chirpie! 🐦"

{
  "tool": "chirpie_post",
  "arguments": {
    "account_id": "YOUR_ACCOUNT_ID",
    "text": "Hello from Chirpie! 🐦"
  }
}

Response Format

All API responses follow a consistent format:

// Success
{ "data": { ... } }

// Error
{ "error": { "code": "error_code", "message": "Human-readable description" } }

Base URL

https://chirpie.ai/api/v1

Next Steps

Authentication — API key setup and best practices
Posts API — Create, list, and delete posts
Threads API — Create multi-post threads
Scheduling — Schedule posts for later
CLI Reference — Command-line interface
Skills — Teach AI coding agents to use Chirpie

On this page