Getting Started

What is the Wahlu API?

The Wahlu API lets you programmatically manage your social media content. Create posts, schedule publications, manage queues, upload media, and more — all from your own code or automation tools.

Base URL

All API requests should be made to:

https://api.wahlu.com/v1

Quick start

1. Create an API key

Open your Wahlu dashboard, go to Settings → API Keys, and create a new key. Choose the scopes your application needs and, optionally, restrict the key to specific brands.

2. Make your first request

Fetch the list of brands connected to your account:

curl https://api.wahlu.com/v1/brands \
  -H "Authorization: Bearer wahlu_live_your_api_key_here"

const response = await fetch("https://api.wahlu.com/v1/brands", {
  headers: {
    Authorization: "Bearer wahlu_live_your_api_key_here",
  },
});

const { data } = await response.json();
console.log(data);

3. Check the response

You should receive a JSON response containing your brands:

{
  "success": true,
  "data": [
    {
      "id": "brand_abc123",
      "name": "My Brand",
      "logo_url": "https://storage.wahlu.com/logos/my-brand.png",
      "timezone": "Europe/London",
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-02-01T14:20:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "has_more": false
  }
}

What's next?

• Authentication — Learn about API key scopes and brand restrictions.
• Rate Limits — Understand the request limits and how to handle throttling.
• API Reference — Browse all available endpoints.
• MCP Server — Use Wahlu with AI coding tools like Claude Code and Cursor.