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

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.

Memberships

Create membership

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

Description

Links a Person to an Organization with a role (the "add person to org" flow). Resolve
both sides by `public_id` (preferred); legacy numeric `person_id` / `organization_id`
still work. Optional `title` gives the membership a human-readable label such as
"Head of Outreach". `start_date` is required; `end_date` marks a past role.

**Body shapes accepted:** canonical (`{ "membership": { … }, "source_reference": { … } }`),
`source` / `citation` aliases for the citation, or a flat top-level body. You can also
nest `email_addresses_attributes` (or the friendlier `emails: [ "addr", … ]`) to attach
work emails on create.

To create a person and their first membership in a **single** API call, use
`POST /api/v1/people/quick_add` with `organization_public_id` set.

Requires `can_edit`. Costs one credit.

Try & reference

Open in Swagger UI — this path is pre-selected; use Authorize with your API key.
Memberships 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/memberships 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.