Create an organization
Create a new organization.
Whoever creates it becomes its owner. It starts out pending: members can look around, but applications and sites, and with them data ingestion, wait for a review. An account that was granted auto-approval skips that queue.
Takes a signed-in dashboard session. A bearer token is refused, because a key is bound to the organizations it was issued for and must not be able to write its own reach.
bearerAuthAuthorizationBearer <token>API token generated from the fastmon dashboard (Account → API Token) or at organization level (fmo_…, one that outlives its creator). Send as Authorization: Bearer fm_... or paste the full token (including its prefix) into the Authorize dialog.
application/json- body
name*NameDisplay name.
1 <= length <= 128intended_domain*Intended DomainThe domain that will be monitored. Used for the review.
Successful Response
application/json- response
id*IdIdentifier of the organization.
uuidname*NameDisplay name.
is_active*Is ActiveWhether the organization is enabled.
review_status*ReviewStatusWhere the organization stands in the anti-abuse review. Applications and sites, and with them ingestion, wait for approval.
"pending""approved""blocked"intended_domain?Intended DomainThe domain the organization said it wants to monitor, from sign-up.
storage*StorageWhich ClickHouse storage tier holds this organization's beacons.
"shared""dedicated""external"clickhouse_table*Clickhouse TableThe table its beacons are read from.
plan*PlanSubscription plan.
"none""free""one""partner""enterprise"is_partner*Is PartnerWhether this organization manages client organizations as an agency.
ai_enabled*Ai EnabledWhether AI features are switched on for it.
synthetic_enabled*Synthetic EnabledWhether synthetic monitoring is switched on for it.
mcp_enabled*Mcp EnabledWhether the MCP server is switched on for it.
features?array<>Every catalog feature with what makes it available to this organization. A locked one is shown with its upsell, not hidden.
[]role?RoleThe caller's role here.
"owner""member""viewer"permissions?array<string>What that role currently means for the caller. Gate a UI on this rather than on the role, so a re-cut role bundle needs no client change.
[]access?AccessHow the caller reaches this organization: through a membership, through a partner link, or through the platform-admin bypass.
"member""partner""admin"curl -X POST 'https://api.fastmon.eu/organizations' \ -H 'Content-Type: application/json' \ -d '{ "name": "string", "intended_domain": "string"}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "is_active": true, "review_status": "pending", "intended_domain": "string", "storage": "shared", "clickhouse_table": "string", "plan": "none", "is_partner": true, "ai_enabled": true, "synthetic_enabled": true, "mcp_enabled": true, "features": [], "role": "owner", "permissions": [], "access": "member"}