Skip to main content

Documentation Index

Fetch the complete documentation index at: https://orbit-docs.devotel.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Integrations API

Connect third-party SaaS apps (Salesforce, HubSpot, Shopify, Stripe, 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: /v1/integrations Authentication: API key (X-API-Key) or session JWT.

​
Connections

MethodPathPurpose
GET/v1/integrationsList connected integrations
POST/v1/integrations/connectInitiate an OAuth connect flow
GET/v1/integrations/{id}/statusConnection health + last sync
DELETE/v1/integrations/{id}/disconnectDisconnect (revokes provider tokens)

​
Sync & data

MethodPathPurpose
POST/v1/integrations/{id}/syncTrigger a sync now
GET/v1/integrations/{id}/dataRead synced records

​
Inbound webhook

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

​
Example — initiate a Salesforce connection

curl -X POST https://orbit-api.devotel.io/api/v1/integrations/connect \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "salesforce",
    "return_url": "https://yourapp.com/integrations/done"
  }'
The response includes an OAuth auth_url — redirect the user to it. After consent, Nango redirects to return_url with the connection ID.