How do I authenticate POST /api/v1/organizations?

Send your per-user API key as Authorization: Bearer or use the X-Api-Key header with the same value on every request.

Where can I try this endpoint interactively?

Use Swagger UI (Authorize with your key) or the in-browser API playground linked from the API documentation. Both match the published OpenAPI specification.

Organizations

Create organization

POST /api/v1/organizations on the Little Outreach JSON API. Send Authorization: Bearer or X-Api-Key on every request.

Description

Creates an Organization with a citation in one transaction.

**Body shapes accepted (pick one):**

1. Canonical nested — `{ "organization": { … }, "source_reference": { … } }`.
2. Friendlier — `source` or `citation` instead of `source_reference`; `category` inside
the citation for `source_category`.
3. Flat top-level — send profile fields without the `organization:` wrapper, e.g.
`{ "name": "…", "domain": "…", "organization_type": "…", "source": { … } }`.

The `advertiser` alias also works (identical behaviour and payloads, just different JSON
keys — see `POST /api/v1/advertisers`).

To link a Person to the new Organization in the same request, use
`POST /api/v1/people/quick_add` with `organization_public_id` set to the returned
`public_id`. Requires `can_edit`. Costs one credit.

Try & reference

Open in Swagger UI — this path is pre-selected; use Authorize with your API key.
Organizations playground — labelled form fields for this resource's most common actions.
Full-surface playground — send any method to any path.
OpenAPI YAML — full machine-readable specification.

Quick answers

How do I call this endpoint?: Send POST /api/v1/organizations to your deployment’s host with Authorization: Bearer or X-Api-Key set to your API key.
Where can I try it interactively?: Use Swagger UI (Authorize with your key) or the API playground.