---
title: "Get started with Unified.to"
url: "https://docs.unified.to/quick-start"
description: "Quick start guide for making your first API call with Unified.to"
generated_at: "2026-06-19T20:59:22.917Z"
---
Table of Contents

# Get started with Unified.to

This quick start guides you through connecting your application to third-party platforms using Unified.to. You'll see how to:

* Set up your Unified.to account and credentials
* Activate integrations in the sandbox environment
* Add the Authorization component to your app
* Make your first API call

Want to play around with the Unified API right away? Download [Postman](https://www.postman.com/downloads/) and import our [Postman collection](/reference/sdks) to start making API calls. You'll need your workspace ID and API key first.

## [Set up your workspace](#set-up-your-workspace)

1. Create your Unified.to account
  * Sign up at [app.unified.to/login](https://app.unified.to/login)
  * Log in to your dashboard
2. Get your API credentials
  * Navigate to **Settings > API Keys**
  * Copy your **Workspace ID** and **API Key**
  * Store these securely where you can reference them in your app, such as in an `.env` file - you'll need them for API calls
3. Activate an integration in the sandbox environment
  * Go to **Integrations**
  * Select **Sandbox** from the environment dropdown in the top-right corner of the screen
  * Search for your desired integration
  * Click the integration card and select **Activate** (don't worry about filling in credentials - they're all mocked in the sandbox environment)

![Search for integrations in the sandbox environment](/_ipx/q_80/images/screenshots/quick-start-integrations.png)

## [Add authorization to your app](#add-authorization-to-your-app)

Your users need to authorize your application to access their third-party accounts (like Lever, HubSpot, etc.). Unified.to provides an embedded Authorization component that handles this process securely. When users click on an integration in this component, they'll be redirected to an authorization page, then returned to your app with a unique connection ID that you'll use for making API calls.

![Quick start auth component](/_ipx/q_80/images/screenshots/quick-start-auth-component.png)

Add this to your app:

```
<script src="https://api.unified.to/docs/unified.js?wid=YOUR_WORKSPACE_ID&did=unified_widget&env=Sandbox"></script>
<div id="unified_widget"></div>

```

Replace `YOUR_WORKSPACE_ID` with the Workspace ID you copied earlier.

(Want to use a Javascript framework or make the API call from your server? Discover more options at [app.unified.to/embed](https://app.unified.to/embed?tab=Authorization))

## [Make your first API call](#make-your-first-api-call)

After successful authorization, you'll receive a connection ID in the callback URL e.g. `localhost:3000?id={connection_id}`. Save this in your database and use it to make API calls.

Our Unified endpoints generally follow the pattern of `{API_CATEGORY}/{CONNECTION_ID}/{DATA_OBJECT}`. For example:

### [CRM (HubSpot, Salesforce, etc.)](#crm-hubspot-salesforce-etc)

```
// Fetch contacts
const response = await fetch(`https://api.unified.to/crm/${connectionId}/contact`, {
    headers: {
        Authorization: `Bearer ${API_KEY}`,
    },
});

```

### [ATS (Lever, Greenhouse, etc.)](#ats-lever-greenhouse-etc)

```
// Fetch candidates
const response = await fetch(`https://api.unified.to/ats/${connectionId}/candidate`, {
    headers: {
        Authorization: `Bearer ${API_KEY}`,
    },
});

```

### [HRIS (BambooHR, Workday, etc.)](#hris-bamboohr-workday-etc)

```
// Fetch employees
const response = await fetch(`https://api.unified.to/hris/${connectionId}/employee`, {
    headers: {
        Authorization: `Bearer ${API_KEY}`,
    },
});

```

Refer to our **API Reference** for the category and data object you are interested in.

## [Next steps](#next-steps)

When you're ready to move on to production environments, review these guides to set yourself up for success:

* [Learn how to work with webhooks](https://docs.unified.to/concepts/webhooks)
* [Configure scopes for your authorization flow](https://docs.unified.to/concepts/scopes)
* [Associate your end-users with connections](https://docs.unified.to/guides/how%5Fto%5Fassociate%5Fa%5Fconnection%5Fid%5Fwith%5Fyour%5Fend%5Fuser)
* [SDKs for popular languages](https://docs.unified.to/reference/sdks)

Need help?

* Join our [Discord](https://discord.gg/2nsAPmbx)
* Email [hello@unified.to](mailto:hello@unified.to)

* [Set up your workspace](#set-up-your-workspace)
* [Add authorization to your app](#add-authorization-to-your-app)
* [Make your first API call](#make-your-first-api-call)
* [Next steps](#next-steps)