> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usehandled.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrated Accounts API

> Manage connected accounts programmatically

## List Integrated Accounts

Retrieve all connected accounts in your environment.

<CodeGroup>
  ```bash cURL theme={null}
  curl 'https://api.usehandled.io/api/v1/ipaas/integrated-account' \
    -H 'Authorization: Bearer YOUR_API_TOKEN'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.usehandled.io/api/v1/ipaas/integrated-account', {
    headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
  });
  const data = await response.json();
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "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.

```bash theme={null}
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.

```bash theme={null}
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.

<Warning>
  This action cannot be undone. All account data and API logs will be deleted.
</Warning>

```bash theme={null}
curl -X DELETE 'https://api.usehandled.io/api/v1/ipaas/integrated-account/{account_id}' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'
```

## Filter by Integration

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

## Filter by Tenant

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