Skip to main content

​
Prerequisites

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

​
Step 1: Get Your API Token

  1. Log into your Handled dashboard
  2. Go to Settings > API Tokens
  3. Click Create API Token
  4. Copy and store the token securely
Keep your token secret. Anyone with your token can access your account.

​
Step 2: Install an Integration

  1. Go to Catalog > Integrations in your dashboard
  2. Find the integration you need (e.g., ShipHero, Shopify)
  3. Click Install
  4. 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