Skip to content

Create an organization

POST
/organizations
curl --request POST \
--url https://api.perstat.io/organizations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "name": "example" }'

Creates a new organization owned by the caller; the URL slug is derived from the name. Returns 409 when the per-user organization limit is reached or the slug is already taken.

Media typeapplication/json
object
name
required
string
Examplegenerated
{
"name": "example"
}
Media typeapplication/json
object
id
required
string
name
required
string
slug
required
string
Examplegenerated
{
"id": "example",
"name": "example",
"slug": "example"
}