---
title: "Getting Started"
description: "This article provides quick ways to begin using TagoIO, including manual steps, a simulator option, and an introductory video, plus the first step to add a device."
---

# Getting Started

> This article provides quick ways to begin using TagoIO, including manual steps, a simulator option, and an introductory video, plus the first step to add a device.

Welcome to TagoIO! Get started by adding a device to your account.

### Step 1. Add a device

Start by adding a [device](https://admin.tago.io/devices) to your account. This
will provide a link between the data in your account and the external world.

In this example, you will send a variable called _temperature_ from your device
to your account.

1. Click the **Device** button on the left sidebar.
2. Click the **Add Device** button.
3. Look for the type **HTTPS** and select it.
4. In the field _"Device Name"_, add any name for your device.
5. Click the **Create Device** button.

![Image 1](/docs_imagem/tagoio/devices-list-new-device.gif)

All devices should use a valid
[device-token](/docs/tagoio/devices/device-token.md) when accessing TagoIO. One
device‑token is generated when a device is created and it is available for you
to copy if you want to insert it in a real device.

![Image 2](/docs_imagem/tagoio/devices-token-rate-limits-setup.gif)

### Step 2. Build a dashboard

You can build great [dashboards](/docs/tagoio/dashboards/) to visualize data,
interact with your devices and share with others. You can build it with the
[widgets](/docs/tagoio/widgets/) that best fit your needs.

1. Click **Dashboards** on the left side bar.
2. Click **+**, then select the type of dashboard, give a name for your
   dashboard, and click **Save**.
3. Add one widget to show the variable _temperature_. Click **+** (the top right
   button), and pick the widget **Card**.
4. Start the configuration of this widget by adding the device and variable to
   be displayed. Click on the search area then type the variable name that will
   be sent by the device as temperature, and click **Save**. Your widget will
   be ready!

![Image 3](/docs_imagem/tagoio/widgets-dashboard-template-creation-concept.gif)

### Step 3. Send data

Now that you have completed the setup of your account, you are ready to send
data from your electronic devices using our
[APIs](/docs/tagodeploy/project/api.md). You can use one of our
[SDKs](/docs/tagoio/analysis/sdk/) designed for your platform.

You can simulate your device using any tool that transfers data to and from a
server with HTTP. Below, you will learn how to quickly send data depending on
the OS that you are using.

#### Mac or Linux

Use curl to post the data. Enter the following command replacing the
**<Device-Token>** by the token created earlier for your device.

```bash
curl -L 'https://api.us-e1.tago.io/data' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Device-Token: <Device-Token>' \
-d '[
    {
        "variable": "temperature",
        "value": 27,
        "unit": "F"
    }
   ]'
```

#### Windows

To send data, there are some tools that support HTTP communication like
[Postman](/docs/api/sidebar/tagoio-api-intro) or Insomnia. Considering the same
input as used above, you can make a POST by entering the URL, Device-Token, and
configuration in Postman like this:

![Image 5](/docs_imagem/tagoio/getting-started-api-post-request-headers.png)

Then, input the variable information in the JSON body. Make sure that you select
the same configuration as shown in the picture below, and click send!

![Image 6](/docs_imagem/tagoio/getting-started-api-post-request-body.png)

### Step 4. Create complete solutions

This is just the beginning! See how TagoIO helps you deploy solutions in
production.

Create an [Analysis](/docs/tagoio/analysis/) in real-time using our script capabilities in JavaScript. Program [actions](/docs/tagoio/actions/) to be taken based on your rules.

Learn more about our
[APIs](/docs/tagodeploy/project/api.md), and check out the
tutorials and [SDKs](/docs/tagoio/analysis/sdk/) prepared for different boards
and applications.

[llms.txt](https://docs.tago.io/llms.txt)