distribute.youdistribute.you
Start

distribute.you API Reference

Direct REST API access to distribute.you. The machine-readable contract for everything on this page is the OpenAPI document.

Interactive API Reference

Try endpoints directly in the browser with our Scalar-powered docs.

Open API Docs

Base URL

https://api.distribute.you/v1

Authentication

All requests require your API key in the Authorization header:

curl https://api.distribute.you/v1/me \
  -H "Authorization: Bearer distrib.usr_YOUR_KEY"

From a shell

The CLI is the shortest path from a terminal or a CI job. It authenticates once with an API key, prints JSON on stdout, prints JSON on stderr when it fails, and exits non-zero, so it can be driven without parsing prose.

npx @distribute.you/cli --help

distribute ops lists every operation this API has, read from the API itself rather than from a list that can go stale. The package is on npm as @distribute.you/cli.

Errors

CodeMeaning
400Bad request: invalid parameters
401Unauthorized: invalid or missing API key
404Resource not found
429Rate limit exceeded
500Internal server error

Endpoints

Brands

Create brands from URLs, extract structured data with AI

Features

Browse automation types, stats, and prefill inputs

Campaigns

Create, stop, and monitor campaigns

Workflows

Inspect workflows, DAGs, and key status

Leads

List discovered leads and their outreach status

Emails

View generated emails and sequences

Billing

Balance, account settings, transactions

Costs

Cost breakdown and delivery statistics

Webhooks

Real-time event notifications

Every developer surface distribute.you publishes, this API included, is named together at https://distribute.you/developers.