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 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

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.

API Reference

All Endpoints

Integrations API

Integrations API

Connections

Sync & data

Inbound webhook

Example — initiate a Salesforce connection

​Integrations API

​Connections

​Sync & data

​Inbound webhook

​Example — initiate a Salesforce connection

Integrations API

Connections

Sync & data

Inbound webhook

Example — initiate a Salesforce connection