> For the complete documentation index, see [llms.txt](https://docs.connectedyou.io/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.connectedyou.io/knowledge-base/connectedyou-platform/api-docs/apis-reference.md).

# APIs Reference

Welcome to IOH API. Here you'll find all the documentation you need to get up and running with the APIs for the [IoT Orchestration Hub](https://console.connectedyou.io).

You can find our APIs at [docs.api.connectedyou.io](https://docs.api.connectedyou.io/#intro).

Feel free to write in to our [support desk](https://connectedyou.atlassian.net/servicedesk/customer/portal/1/group/1/create/10) for any questions or suggestions.

There are 3 basic steps to follow to get quickly started using the IOH APIs:

* [Authenticate](#authenticate)
* [Get account ID](#get-account-id)
* [Use the APIs](#make-your-first-request)

## Authenticate

Use the Auth endpoint: [`https://api.connectedyou.io/`](https://api.connectedyou.io/) to authenticate and generate the access tokens.

As part of the response you will receive an `access_token` that you must use in authorization headers henceforth.

The access token typically lasts for 1 hour for security reasons. You will need to either use a `refresh_token` to generate a new access token or you can re-authenticate.

## Get account ID

Using the API endpoint: [`https://api.connectedyou.io/v1`](https://api.connectedyou.io/v1), you can now retrieve the account ID for your user.&#x20;

Select one of the account IDs that you have access to.&#x20;

{% hint style="info" %}
You can also find your account ID on your account settings page.&#x20;
{% endhint %}

<figure><img src="/files/BJFRKkOnN6DZ8pcd6JPZ" alt=""><figcaption></figcaption></figure>

## Make your first request

To make your first request in your account, send an authenticated request to the API endpoint: [`https://api.connectedyou.io/v1`](https://api.connectedyou.io/v1).&#x20;

Now you are well on your way to trying out the other APIs to automate your workflows.
