POST/user/v1/organizations
Create an organization
Creates a new organization.
body parameters
The client defined unique identifier of the organization account.
It is restricted to letters, numbers, underscores, and hyphens, with the first character a letter or a number, and a 255 character maximum.
ID's starting with org_ are reserved.
The human-readable display name of the organization.
The maximum length is 200 characters.
The email address of the organization.
The maximum length is 320 characters.
The flow identifier associated with the creation of the organization.
The flow type must be SIGNUP and associated with the user creating the organization.
Returns
The system-assigned identifier of the organization.
The client defined unique identifier of the organization account.
The human-readable display name of the organization.
The email address of the organization.
Whether the organization's email address has been verified.
The photo/avatar URL of the organization.
The number of members in the organization.
This includes disabled users, but does not include user's marked for deletion.
Whether the organization is disabled.
The general error code (e.g. INVALID_ARGUMENT).
Possible values:OKCANCELLEDUNKNOWNINVALID_ARGUMENTDEADLINE_EXCEEDEDNOT_FOUNDALREADY_EXISTSPERMISSION_DENIEDUNAUTHENTICATEDRESOURCE_EXHAUSTEDFAILED_PRECONDITIONABORTEDOUT_OF_RANGEUNIMPLEMENTEDINTERNALUNAVAILABLEDATA_LOSS
A developer-facing error message.
A reason code for the error (e.g. USER_PENDING_DELETION).
The parameter path related to the error (e.g. member.userId).
Additional metadata related to the error.
curl https://api.userhub.com/user/v1/organizations \
-H "UserHub-Api-Key: $USER_API_KEY" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
--json '{
"displayName": "Acme Inc"
}'
const res = await userApi.organizations.create({
displayName: "Acme Inc",
});
res, err := userApi.Organizations().Create(
context.Background(),
&userapi.OrganizationCreateInput{
DisplayName: "Acme Inc",
},
)
$res = $userApi->organizations->create(
displayName: 'Acme Inc',
);
res = user_api.organizations.create(
display_name="Acme Inc",
)
Response bodyJSON
{
"id": "org_28seyVGVL1got6",
"displayName": "Acme Inc",
"memberCount": 1
}