Skip to main content

Integrations

This page describes the pre-built integrations ORKSTRA ships, and the recipe patterns for building your own.

Pre-built integrations​

Accounting​

  • QuickBooks Online — bi-directional sync of invoices, payments, and journal entries.
  • Xero — same.
  • Tally (India / KSA) — daily journal export.
  • SAP B1 — read-only feed from SAP into ORKSTRA for cost re-mapping.

BI / data warehouse​

  • Power BI — DirectQuery connector. Refreshes on demand.
  • Tableau — JDBC connector via the OData feed.
  • BigQuery / Snowflake — daily Parquet drop to your cloud storage.

Identity​

  • Microsoft Entra ID (Azure AD) — SAML SSO + SCIM provisioning.
  • Okta — SAML SSO + SCIM.
  • Google Workspace — OIDC SSO.

Communications​

  • Slack — pipe notifications to Slack channels.
  • Microsoft Teams — same.
  • WhatsApp Business — via Twilio.

Government (UAE)​

See Govt Integration — MoHRE, ICA, GDRFA.

Recipe patterns​

Pattern 1: nightly invoice sync to accounting​

EVERY day at 02:00
  PULL certified IPCs since last sync
  FOR each IPC:
    CREATE invoice in accounting via accounting API
    STORE mapping in ORKSTRA via API
    EMIT audit event
END

Pattern 2: real-time BI mirror​

SUBSCRIBE to events: project.created, project.updated, boq.revised, ipc.certified
ON event:
  FETCH full entity via REST API
  UPSERT into data warehouse staging table
END

Pattern 3: SCIM user provisioning​

LISTEN on /scim/v2/Users endpoint
ON create:
  CREATE user in ORKSTRA with mapped role
ON update:
  UPDATE user attributes
ON delete:
  DEACTIVATE user (do not hard delete — preserves audit)
END

Building a custom integration​

  1. Pick auth mode. Server-to-server → client credentials. User app → authorization code + PKCE.
  2. List required scopes. Don't ask for * — pick narrow scopes.
  3. Choose pull vs. push. Webhooks > polling unless you need historical reads.
  4. Handle pagination, retries, dedupe. See API reference.
  5. Test against a sandbox tenant — ORKSTRA can provision a sandbox on request.
  6. Submit for partner certification if you want to be listed in the ORKSTRA partner catalog.

Partner program​

If you're building a product on top of ORKSTRA, the partner program offers:

  • Sandbox tenant for development.
  • Co-marketing on orkstra.com.
  • Listing in the partner catalog.
  • Technical support during integration.

Contact partners@orkstra.com.

See also: API reference, Webhooks, SDKs.