Quickstart

Prerequisites

A Handled account (sign up here)
An API token from the dashboard

Step 1: Get Your API Token

Log into your Handled dashboard
Go to Settings > API Tokens
Click Create API Token
Copy and store the token securely

Keep your token secret. Anyone with your token can access your account.

Step 2: Install an Integration

Go to Catalog > Integrations in your dashboard
Find the integration you need (e.g., ShipHero, Shopify)
Click Install
Select your environment (Development, Staging, or Production)

Step 3: Connect an Account

Generate a link token to start the connection flow:

curl -X POST 'https://api.usehandled.io/api/v1/ipaas/link-token' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "tenant_id": "customer-123"
  }'

Response:

{
  "link_token": "abc123-def456-ghi789"
}

Open the connection UI:

https://ipaas.usehandled.io/connect-account?link_token=abc123-def456-ghi789

Step 4: Make Your First API Call

Once an account is connected, fetch data using the Unified API:

curl 'https://api.usehandled.io/api/v1/ipaas/unified/wms/orders?integrated_account_id=ACCOUNT_ID&limit=10' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Response:

{
  "result": [
    {
      "id": "order-123",
      "status": "pending",
      "line_items": [...],
      "shipping_address": {...}
    }
  ],
  "next_cursor": null
}

Next Steps

Unified APIs

Learn about standardized data access

Webhooks

Set up real-time notifications

Sync Jobs

Automate data synchronization

Link SDK

Embed the connection UI in your app

Introduction

Platform Overview

Getting Started

How Handled Works

Integrations

Unified APIs

Integrated Accounts

Webhooks

Link SDK

RapidBridge (Sync Jobs)

RapidForm

Workflows

Platform

Prerequisites

Step 1: Get Your API Token

Step 2: Install an Integration

Step 3: Connect an Account

Step 4: Make Your First API Call

Next Steps

Unified APIs

Webhooks

Sync Jobs

Link SDK

​Prerequisites

​Step 1: Get Your API Token

​Step 2: Install an Integration

​Step 3: Connect an Account

​Step 4: Make Your First API Call

​Next Steps

Unified APIs

Webhooks

Sync Jobs

Link SDK

Prerequisites

Step 1: Get Your API Token

Step 2: Install an Integration

Step 3: Connect an Account

Step 4: Make Your First API Call

Next Steps