Create 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 'logo=@logoname'

Header

Parameter	Type	Description
X-Auth-Token	String	[Authentication Token] (/reference/authentication) 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.