Create Organization

POST {{baseUrl}}/v1/organization

Creates a new Organization for the current account

  1. We use different authentication in the x-auth header for /organization endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET(separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.
  2. Are you using REST API for creating Organizations? Make sure that the user token used for creating a new Organization belongs to the user with Company role Master or Owner.
  3. It is important to note that after creating a Company through REST API, the default Device plan is set to 3.0. This can be changed from within SignageOS Box under your Company profile

Parameters

FieldTypeRequiredDescription
no parameters required

Body

FieldTypeRequiredDescription
namestringrequiredOrganization name

Can contain only letters and numbers separated by dashes and it must start and end with a letter or a number

Min 2 and max 255 length

Example: signageos-test-org-1
titlestringrequiredOrganization title

Min 2 and max 255 length

Example: SignageOS Testing Organization

In the response, you can find Location header with a link to the created organization.

HEADERS

KeyDatatypeRequiredDescription
x-authstringAccount authorization key and token
Content-Typestring
Content-Typestring
Acceptstring

RESPONSES

status: Created

{}