Skip to main content

​
List Integrated Accounts

Retrieve all connected accounts in your environment. 
curl 'https://api.usehandled.io/api/v1/ipaas/integrated-account' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

​
Response

{
  "result": [
    {
      "id": "acc_123",
      "tenant_id": "customer-456",
      "integration": {
        "name": "shiphero",
        "label": "ShipHero"
      },
      "status": "active",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "next_cursor": null
}

​
Get Integrated Account

Retrieve a specific connected account. 
curl 'https://api.usehandled.io/api/v1/ipaas/integrated-account/{account_id}' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

​
Update Integrated Account

Update account context variables or overrides. 
curl -X PATCH 'https://api.usehandled.io/api/v1/ipaas/integrated-account/{account_id}' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "context": {
      "warehouse_id": "wh-789"
    }
  }'

​
Delete Integrated Account

Permanently delete a connected account.
This action cannot be undone. All account data and API logs will be deleted.
curl -X DELETE 'https://api.usehandled.io/api/v1/ipaas/integrated-account/{account_id}' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

​
Filter by Integration

curl 'https://api.usehandled.io/api/v1/ipaas/integrated-account?integration.name=shiphero' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

​
Filter by Tenant

curl 'https://api.usehandled.io/api/v1/ipaas/integrated-account?tenant_id=customer-456' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'