Add an office location
POST
/org-admin/{slug}/locations
Adds a location. With is_primary: true it becomes the primary location and the previous primary is cleared in the same transaction. Locations are hidden from the public profile unless is_publicly_visible is true.
Requires permission: org.manage_locations
Authorizations
BearerAuth
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Type
HTTP (bearer)
Parameters
Path Parameters
slug*
The organization's slug (not its UUID).
Type
Requiredstring
Example
"local-food-bank-a1b2c3"Pattern
"^[a-z0-9][a-z0-9-]{0,254}$"Request Body
application/json
JSON
{
"label": "Headquarters",
"address": "string",
"is_primary": false,
"is_publicly_visible": false
}
Responses
Location added
application/json
JSON
{
"data": "string"
}