📘
Enterprise license
This feature requires an Enterprise License. Please contact sales@ubidots.com for further information

Request

To create a new Access Token, please make a POST request to the following URL:

HTTP Method	URL
POST	`https://industrial.api.ubidots.com/o/token/`

Key Parameters

Add the following parameters to the body of your request:

Key	Type	Value	Required?	Description
grant_type	String	password	Yes	The grant authorization type
username	String	-	Yes	The username of the end user
password	String	-	Yes	The password of the end user
audience	String	-	No	Your API identifier
scope	String	read:write	Yes	The scope of the authentication, it could be for read or write purposes
client_id	String	-	Yes	The client ID of your account
client_secret	String	-	Yes	The client secret of your account

🚧
Client ID and Client Secret
You must request the client_id and client_secret to the technical Ubidots team. Please send this request to the following e-mail: support@ubidots.com

Header

Parameter	Type	Description
Content-Type	String(application/x-www-form-urlencoded)	Content type of keys

curl --location --request POST 'https://industrial.api.ubidots.com/o/token/' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data 'grant_type=password' \
--data 'username=check' \
--data 'password=75904268leo' \
--data 'scope=read write' \
--data 'client_id=CNpL7wnnnBdTp8uUNKDK5KjT8cV28TA6wOu4Psst' \
--data 'client_secret=TC8B8vSeVNCOuMyGIZ4Pmxjf52c8dPyteJRVjxxai5SIpNmI0APluWHBr0XLzs6i6GGAN5cViY7DnzqypKcetaq8Msky9hOeHYu46C96hgIfldqpo5IVWQJ2M57KEHhe'

{
  "access_token": "UmXZ6WavsakMLtaIQ7P9p9y0M1HBSs",
  "expires_in": 36000,
  "token_type": "Bearer",
  "scope": "read write",
  "refresh_token": "aFcDvEmm0zDjJd4vcSE9AtMlIcnpoP"
}

{
  "error": "invalid_grant",
  "error_description": "Invalid credentials given."
}

Returns an Object containing the oAuth2 session.

📘
List of endpoints available with Auth2
/v2.0/devices/
/v2.0/devices/<device_key>/
/v2.0/devices/<device_key>/variables/
/v2.0/variables/
/v2.0/variables/<variable_key>/
/v1.6/variables/<variable_key>/values
/api/v2.0/users/
/api/v2.0/users/<user_key>

Header

Parameter	Type	Description
Content-Type	String(application/json)	Content type of body
Authorization: Bearer	String	Access Token

curl --request GET \
--url 'https://industrial.api.ubidots.com/api/v2.0/devices/' \
-H 'Authorization: Bearer cBBLtgOhfYImGiH47QLG1OTKjtqDd0'\

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "url": "https://industrial.api.ubidots.com/api/v2.0/devices/639a820378b2b3000cd18c0e",
      "id": "639a820378b2b3000cd18c0e",
      "organization": {
        "url": "https://industrial.api.ubidots.com/api/v2.0/organizations/62b4eb3519cd98007bf410bf",
        "id": "62b4eb3519cd98007bf410bf",
        "label": "my-third-customer",
        "name": "Cliente1",
        "createdAt": "2022-06-23T22:37:41.840643Z"
      },
      "label": "xbee",
      "name": "xbee",
      "description": "",
      "tags": [],
      "properties": {},
      "isActive": true,
      "lastActivity": 1671110138954,
      "createdAt": "2022-12-15T02:10:11.432971Z",
      "variables": "https://industrial.api.ubidots.com/api/v2.0/devices/639a820378b2b3000cd18c0e/variables",
      "variablesCount": 1
    }
  ]
}

{
  "code": 401002,
  "message": "Incorrect authentication credentials."
}

Returns an object with the requested endpoint.