Page creation

Step-by-step guide on how to create a Page

A Page is the entity in Ubidots that holds your custom code and provides a reference that can be loaded from a Dashboard page.

All CRUD operations for Pages — create, read, update, and delete — are also available through the API, in addition to the dedicated UI. See the API Reference for more details.

Create

Make the following HTTP request:

curl -X POST 'https://industrial.api.ubidots.com/api/v2.0/pages' \
-H 'X-Auth-Token: <YOUR_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{"name": "My First Page"}'

The response will look like this:

{
  "id": "66fc141609164d000e1e0fab",
  "url": "https://industrial.api.ubidots.com/api/v2.0/pages/66fc141609164d000e1e0fab",
  "label": "my-first-page",
  "name": "My First Page",
  "isActive": true,
  "createdAt": "2024-10-01T15:24:06.863703Z",
  "settings": {}
}

The name value is used to create the Page label by converting it to lowercase and replacing spaces with dashes.

List

List all your Pages with the following HTTP request:

curl -X GET 'https://industrial.api.ubidots.com/api/v2.0/pages' \
-H 'X-Auth-Token: <YOUR_TOKEN>'

The response looks like this:

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "66fc141609164d000e1e0fab",
      "url": "https://industrial.api.ubidots.com/api/v2.0/pages/66fc141609164d000e1e0fab",
      "label": "my-first-page",
      "name": "My First Page",
      "isActive": true,
     "createdAt": "2024-10-01T15:24:06.863703Z",
     "settings": {}
    }
  ]
}

Get

Get a specific Page with the following HTTP request:

curl -X GET 'https://industrial.api.ubidots.com/api/v2.0/pages/<pageId>' \
-H 'X-Auth-Token: <YOUR_TOKEN>'

The response is:

{
  "id": "66fc141609164d000e1e0fab",
  "url": "https://industrial.api.ubidots.com/api/v2.0/pages/66fc141609164d000e1e0fab",
  "label": "my-first-page",
  "name": "My First Page",
  "isActive": true,
  "createdAt": "2024-10-01T15:24:06.863703Z",
  "settings": {}
}