Create Organization

This endpoint creates a new Organization

Request

To create a new Organization please make a POST request to the following URL:

HTTP Method

URL

POST

https://industrial.api.ubidots.com/api/v2.0/organizations/

Query Parameters

Parameter

Type

Use

Description

token

String

Authentication

Authentication Token can optionally be sent as a query parameter.

Body Parameters

Parameter

Type

Required?

Default Value

Description

label

String

Yes

N/A (required)

API label of Organization

name

String

No

Same as label

Name of Organization

description

String

No

""

Description of Organization

favicon

Image

No

null

Icon of the Organization, this attribute has to be sent as form-data (-F favicon=/path/logo.png)

logo

Image

No

null

Url of image or logo

properties

Object

No

{}

Organization properties.

isActive

Boolean

No

True

Is True when Organization is active

app

<app_key>

No

null

Key of App (id or label)

🚧

Updating favicon and logo

Our backend is that powerful that it can handle files. There is however one little caveat, the data needs to be sent as form-data. Practically this means simply a different flag in the curl. And important to know, you can send the other attributes as form-data too. There is an example on the right hand side.

curl -X POST 'https://industrial.api.ubidots.com/api/v2.0/organizations/' \ -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73' \ -F 'favicon=path/logo.png' -F '[email protected]'

Header

Parameter

Type

Description

X-Auth-Token

String

Authentication Token of account

Content-Type

String (application/json)

Content type of body

curl -X POST 'https://industrial.api.ubidots.com/api/v2.0/organizations/' \
 -H 'Content-Type: application/json' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73' \
 -d '{
    "name": "My Second Customer",
    "label": "my-second-customer",
    "description": "Other Organization",
    "properties": {"color": "#BADA55"},
    "isActive": true,
    "app": "~my_application"
}'
{
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
        {
            "app": {
                "id": "5dfa39901a9ca53020c6938d",
                "label": "my_application",
                "name": "Ubidots App of Me",
                "url": "https://industrial.api.ubidots.com/api/v2.0/apps/5dfa39901a9ca53020c6938d"
            },
            "createdAt": "2020-01-01T14:05:55.471155Z",
            "description": "Other Organization",
            "devicesCount": 0,
            "favicon":  {
        "h36": "https://iot.cdnedge.bluemix.net/ind/media/logos/ubidots-white_36.png",
         "h50": "https://iot.cdnedge.bluemix.net/ind/media/logos-big/ubidots-white_50.png",
         "raw": "https://iot.cdnedge.bluemix.net/ind/media/logos-raw/ubidots-white.png"   
    },
            "id": "435ab418805c32fa400f",
            "isActive": true,
            "label": "my-second-customer",
            "limits": [
                {
                    "actual_value": 0,
                    "icon": "hdd-o",
                    "max_value": "*",
                    "name": "Devices",
                    "type": "devices"
                },
                {
                    "actual_value": 0,
                    "icon": "envelope",
                    "max_value": "*",
                    "name": "Emails",
                    "type": "emails"
                },
                {
                    "actual_value": 0,
                    "icon": "signal",
                    "max_value": "*",
                    "name": "Variables",
                    "type": "variables"
                },
                {
                    "actual_value": 0,
                    "icon": "users",
                    "max_value": "*",
                    "name": "Users",
                    "type": "users"
                },
                {
                    "actual_value": 0,
                    "icon": "spinner",
                    "max_value": "*",
                    "name": "Dots",
                    "type": "dots"
                },
                {
                    "actual_value": 0,
                    "icon": "mobile-phone",
                    "max_value": "*",
                    "name": "SMS",
                    "type": "sms"
                },
                {
                    "actual_value": 0,
                    "icon": null,
                    "max_value": "*",
                    "name": "Voice",
                    "type": "voice"
                }
            ],
            "logo": {
        "h36": "https://iot.cdnedge.bluemix.net/ind/media/logos/ubidots-white_36.png",
        "h50": "https://iot.cdnedge.bluemix.net/ind/media/logos-big/ubidots-white_50.png",
        "raw": "https://iot.cdnedge.bluemix.net/ind/media/logos-raw/ubidots-white.png"
    },
            "name": "My Second Customer",
            "properties": {"color": "#BADA55"},
            "url": "https://industrial.api.ubidots.com/api/v2.0/organizations/435ab418805c32fa400f",
            "usersCount": 0
        }
    ]
}
{
    "code": 400001,
    "message": "Validation Error.",
    "detail": {
        ....
    }
}
{
    "code": 401001,
    "message": "Authentication credentials were not provided.",
    "detail": "Authentication credentials were not provided."
}

Response

Returns an Organization object of the Organization created.