Quickstart

Welcome to Zilfu

Zilfu is an all-in-one platform for managing, scheduling, and publishing social media content across multiple platforms — from a single dashboard. Compose once, publish everywhere, and build a consistent posting rhythm without the chaos.

This documentation covers the REST API, so you can integrate Zilfu into your own tools and workflows. With the API you can:

Manage workspaces and connected social accounts
Create, schedule, update, and delete posts (including multi-account clusters)
Upload and manage media files
Configure recurring scheduling slots and inspect your upcoming queue
Manage subscriptions, referrals, link-in-bio pages, and webhook endpoints

A few features — analytics dashboards and connecting new social accounts — remain web-only. Everything else is available through the API.

Get an API Key

Every API request must be authenticated with a personal access token. Tokens are created from the Zilfu web app and tied to your user account.

1. Open the Settings page

2. Create a new token

Click Create token, give it a descriptive name (for example, local-dev or my-automation), and confirm.

Your token is shown only once, right after it is created. Copy it immediately and store it somewhere safe — a password manager or a secret store. If you lose it, you'll need to revoke it and create a new one.

3. Keep it secret

Treat your token like a password — anyone with it can act on your account.
Never commit tokens to source control or paste them into client-side code.
Load them from environment variables or a secrets manager instead.
You can review when each token was last used and revoke any token instantly from the same Settings page.

Make Your First Request

Authenticate every request by sending your token as a Bearer token in the Authorization header.

export ZILFU_API_TOKEN="your-token-here"

curl https://zilfu.app/api/spaces \
  -H "Authorization: Bearer $ZILFU_API_TOKEN" \
  -H "Accept: application/json"

A successful response returns the workspaces (called spaces) you have access to. Each space has its own connected accounts, posts, slots, and timezone — most other endpoints are scoped to a space.

Next Steps

Connect Zilfu to your AI assistant — see MCP Setup to use Claude, Cursor, or ChatGPT to schedule posts in plain language.
Browse the full API Reference in the sidebar to explore every available endpoint, request shape, and response.
Start with Spaces to find the workspace you want to operate on, then move on to Accounts, Posts, and Slots.
Set up Webhooks to receive real-time notifications when posts publish, fail, or change state.