Skip to navigation
Connect

Overview

Polytomic Connect allows you to offer data integrations inside your own product. Your customers connect their own systems from your UI, so you can sync data between your systems and theirs. To automate your own Polytomic workspace instead, see the Quickstart.

How it fits together

  1. Create an organization per customer. See Multitenancy.
  2. Create a Harbor per customer to give your product’s AI agent governed access to their data (alternatively, you can also connect your own database, data warehouse, cloud storage bucket, or any other storage system).
  3. Have the customer authenticate their systems with hosted or embedded authentication.
  4. Create syncs between their systems and yours.

Authentication

Polytomic provides the configuration form and handles OAuth for every connection type, so you don’t build either. You choose where the flow runs:

HostedEmbedded
Where it runsA Polytomic-hosted windowA React component in your app
AppearancePolytomic’s layout, with your logoStyled to match your product

Hosted authentication is the fastest to set up and works with any frontend. Embedded authentication keeps the user in your app.

Both flows start by minting a Connect session on your backend with POST /api/connections/connect/ and your API key. The session token only works for that one connection, and expires after 5 minutes by default.