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

# Integrations API

> Connect third-party apps via Nango — Salesforce, HubSpot, Shopify, Zendesk, and 200+ others. Manage connections, trigger syncs, and read synced data.

# Integrations API

Connect third-party SaaS apps (Salesforce, HubSpot, Shopify, Pipedrive, Zendesk, Intercom, …) and pull their data into Orbit for use in flows, AI agents, and contact enrichment. Powered by [Nango](https://nango.dev) under the hood; auth, refresh, rate limiting, and provider-specific quirks are handled for you.

**Base path:** `/api/v1/integrations`

**Authentication:** API key (`X-API-Key`) or session JWT.

## Connections

| Method   | Path                                   | Purpose                              |
| -------- | -------------------------------------- | ------------------------------------ |
| `GET`    | `/api/v1/integrations`                 | List connected integrations          |
| `POST`   | `/api/v1/integrations/connect`         | Initiate an OAuth connect flow       |
| `GET`    | `/api/v1/integrations/{id}/status`     | Connection health + last sync        |
| `DELETE` | `/api/v1/integrations/{id}/disconnect` | Disconnect (revokes provider tokens) |

## Sync & data

| Method | Path                             | Purpose             |
| ------ | -------------------------------- | ------------------- |
| `POST` | `/api/v1/integrations/{id}/sync` | Trigger a sync now  |
| `GET`  | `/api/v1/integrations/{id}/data` | Read synced records |

## Inbound webhook

Nango posts auth + sync events to `POST /api/v1/integrations/webhooks/nango` — internal only. You don't call this directly.

## Example — initiate a Salesforce connection

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/integrations/connect \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "integration_id": "salesforce"
  }'
```

The response includes an OAuth `auth_url` — redirect the user to it. After consent, the connection is established and ready to sync.