Create a community
POST
/communities
The caller becomes the owner. Co-leaders get invites with their role. draft: true keeps it visible to the owner only. Settings are audit-logged; community.created is published.
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)
Request Body
application/json
JSON
{
"name": "string",
"slug": "string",
"kind": "string",
"city_text": "string",
"place_id": "string",
"languages": [
"string"
],
"about": "string",
"guidelines": [
"string"
],
"photo_url": "string",
"avatar_url": "string",
"photo_original_url": "string",
"photo_crop": {
"additionalProperties": "string"
},
"avatar_crop": {
"additionalProperties": "string"
},
"visibility": "string",
"listed": true,
"join_approval": "string",
"membership": "string",
"price_cents": 0,
"yearly_price_cents": 0,
"perks": [
"string"
],
"leaders_join_free": true,
"share_policy": "string",
"add_policy": "string",
"default_alert": "string",
"show_leaders": true,
"co_leaders": [
{
"user_id": "string",
"role": "string",
"additionalProperties": "string"
}
],
"draft": true,
"additionalProperties": "string"
}
Responses
OK
application/json
JSON
{
"data": "string",
"additionalProperties": "string"
}