Quickstart

Introduction

The FeedHorizon API lets you programmatically create, schedule, and publish social media posts across multiple platforms. Everything you can do in the dashboard is also available via the REST API.

Base URL:

https://app.feedhorizon.dev/api/v1

Step 1 — Create an API key

Go to Dashboard → API Keys
Click Create API Key
Give it a name (e.g. "My Script") and select Read & Write permission
Copy the key immediately — it's only shown once

Your key looks like:

fh_aee6d4242ae1d2ff857b4a900904f9e5beac1f2168a6c83da9f63053fda8caf8

Step 2 — Make your first request

List your profiles to confirm the key works:

cURL

curl -X GET https://app.feedhorizon.dev/api/v1/profiles \
  -H "Authorization: Bearer fh_YOUR_API_KEY"

Node.js (fetch)

const res = await fetch('https://app.feedhorizon.dev/api/v1/profiles', {
    headers: {
        'Authorization': 'Bearer fh_YOUR_API_KEY',
    },
});
const { data } = await res.json();
console.log(data);

Python (requests)

import requests

res = requests.get(
    "https://app.feedhorizon.dev/api/v1/profiles",
    headers={"Authorization": "Bearer fh_YOUR_API_KEY"},
)
print(res.json()["data"])

You should receive a JSON response:

{
    "data": [
        {
            "id": "clxyz...",
            "name": "My Brand",
            "color": "#f5d76e",
            "isDefault": true
        }
    ]
}

Step 3 — Create a post

cURL

curl -X POST https://app.feedhorizon.dev/api/v1/posts \
  -H "Authorization: Bearer fh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from the FeedHorizon API!",
    "platforms": ["linkedin"],
    "profileId": "YOUR_PROFILE_ID",
    "publishNow": true
  }'

The response includes the created post with status PUBLISHING (or SCHEDULED / DRAFT depending on options).

Step 4 — Set up webhooks (optional)

Get notified when posts are published or fail:

cURL

curl -X POST https://app.feedhorizon.dev/api/v1/webhooks \
  -H "Authorization: Bearer fh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhooks/feedwave",
    "events": ["post.published", "post.failed"]
  }'

Next steps

Authentication — API key formats, scopes, and security
Error Handling — Error response format and HTTP status codes
Rate Limits — Understand request limits and headers

Introduction

Step 1 — Create an API key

Step 2 — Make your first request

Step 3 — Create a post

Step 4 — Set up webhooks (optional)

Next steps

On this page