Skip to main content
POST
Create Organization

Authorizations

Authorization
string
header
required

Use a valid Bearer token to authenticate.

Body

application/json
organizationName
string
required

Name for the new organization

Required string length: 3 - 100
hubName
string

Hub name. Required if user has no existing owned organization with hubs.

Maximum string length: 100
hubLat
number

Hub latitude. Required if user has no existing owned organization with hubs.

Required range: -90 <= x <= 90
hubLng
number

Hub longitude. Required if user has no existing owned organization with hubs.

Required range: -180 <= x <= 180
copyDataFromFirstOrg
boolean
default:false

Whether to copy data from user's first organization where they have 'owner' role. When enabled, copies: (1) Organization configuration (language, currency, settings), (2) All hubs the user has access to, (3) Custom roles with system permissions only (custom module permissions are excluded), (4) All flows. Note: Default roles (owner, admin, planner, field user) always use standard templates regardless of this setting.

Response

Organization created successfully - returns new access token and user data

status
boolean

Operation success status

message
string

Success message

token
string

New access token for the created organization

expires_in
integer

Token expiration time in seconds

data
object

User data for the new organization

isHubSet
boolean

Always true for new organizations

organizations
object[]

Updated list of all user's organizations