Quickstart

Get up and running with the GhostFlow API in minutes.

Prerequisites

• A GhostFlow account (sign up)
• An active subscription (Free tier works for testing)

Steps

1. Generate an API key

   Go to Settings → API Keys in your dashboard, or use the API:

   curl -X POST https://devcore.getghostflow.io/api/v1/auth/api-keys \
     -H "Authorization: Bearer YOUR_JWT_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"name": "My First Key", "permissions": ["read:campaigns", "read:stats"]}'

   Save the returned key value (starts with gf_). You won’t see it again.

2. Make your first API call

   cURL

   curl https://devcore.getghostflow.io/api/v1/campaigns \
     -H "Authorization: Bearer gf_your_api_key_here"

   TypeScript

   const response = await fetch('https://devcore.getghostflow.io/api/v1/campaigns', {
     headers: { 'Authorization': 'Bearer gf_your_api_key_here' }
   });
   const campaigns = await response.json();
   console.log(campaigns);

   Python

   import requests
   
   response = requests.get(
       'https://devcore.getghostflow.io/api/v1/campaigns',
       headers={'Authorization': 'Bearer gf_your_api_key_here'}
   )
   campaigns = response.json()
   print(campaigns)

3. Check the response

   You’ll get a JSON array of your campaigns:

   [
     {
       "id": "550e8400-e29b-41d4-a716-446655440000",
       "name": "My Campaign",
       "status": "active",
       "created_at": "2025-01-15T10:30:00Z"
     }
   ]

Next steps

• Authentication deep dive — Learn about scopes and key management
• Rate limits — Understand API limits per plan
• API Reference — Explore all available endpoints