Places
Create place
POST
/api/v1/places
on the Little Outreach JSON API. Send
Authorization: Bearer
or
X-Api-Key
on every request.
Description
Attaches a geocoded location (home, office, venue, campus, …) to a Person,
Organization, or Membership. Pick **exactly one** owner:
* `person_public_id` — place lives on the person,
* `organization_public_id` — place lives on the org,
* `membership_public_id` — place is scoped to a specific role,
* or the polymorphic pair `placeable_type` + `placeable_id` (legacy).
Provide at least `address` (recommended — addresses hide the precise coordinates in API
responses) or `latitude` + `longitude`. `source` / `citation` aliases work for the
citation. Requires `can_edit`. Costs one credit.
Try & reference
- Open in Swagger UI — this path is pre-selected; use Authorize with your API key.
- Places 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/placesto your deployment’s host withAuthorization: BearerorX-Api-Keyset to your API key. - Where can I try it interactively?
- Use Swagger UI (Authorize with your key) or the API playground.