Creates an organization

Creates a new organization.

post

Header parameters

Brand-URLstringRequired

The brand URL of the request. This is used to identify the brand.

Example: YOUR_BRAND_URL

Auth-KeystringRequired

This is used to authenticate the request. If the request is not authenticated, the server will return a 401 Unauthorized response.

Example: YOUR_AUTH_KEY

Body

application/jsontext/jsonapplication/*+json

This class represents the request model for command requests related to organizations.

countryCodestring | nullableOptional

The country code of the organization.

Example: US

languageCodestring | nullableOptional

The language code of the organization.

Example: en

namestring · min: 1Required

The name of the organization.

Example: Organization Name

descriptionstring · min: 1Required

The description of the organization.

Example: Organization Description

avatarstring · uri | nullableOptional

The avatar of the organization.

Example: https://example.com/avatar.png

isPrivateboolean | nullableOptional

The is private of the organization. By default, it is set to false.

Example: true

isDefaultboolean | nullableOptional

The is default of the organization. By default, it is set to false.

Example: true

statusstring · enumOptionalPossible values:

Responses

201

The request was successful.

application/json

401

The user is not authorized to access the requested resource. The request is missing the required Auth-Key header.

application/json

403

The user's access was denied.

application/json

429

The user has exceeded the rate limit.

application/json

post

HTTPcURLJavaScriptPython

POST /api/v1/organizations HTTP/1.1
Host: protocol.jframework.io
Brand-URL: text
Auth-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 208

{
  "countryCode": "US",
  "languageCode": "en",
  "name": "Organization Name",
  "description": "Organization Description",
  "avatar": "https://example.com/avatar.png",
  "isPrivate": true,
  "isDefault": true,
  "status": "0 - Inactive"
}

application/jsontext/jsonapplication/*+json

{
  "success": true,
  "statusCode": 200,
  "message": "The request was successful.",
  "data": {
    "id": "sApKpllz4sAplsmzha",
    "code": "DFEC4E7907500C92CD259BB3755C1810",
    "name": "ORG",
    "languageCode": "en",
    "countryCode": "US",
    "avatar": "https://jfw.io/avatar.png",
    "isDefault": true,
    "isPrivate": false,
    "isSystem": false,
    "description": "JFW Organization",
    "status": "Active",
    "statusUser": "Joined",
    "totalMembers": 1,
    "createdUserId": "admin"
  },
  "errors": []
}