# 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. 

Select one of the account IDs that you have access to. 

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

<figure><img src="https://1161709627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs5UAITdOVqUYS9lZreo%2Fuploads%2FEHxPSJRvhVT5sDYBMxRc%2Fimage.png?alt=media&#x26;token=838cb3e5-4b4d-4115-ac2b-8a2a7c459df6" 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.