Skip to navigation

Introduction

Welcome to the Polytomic API documentation. The API does everything the Polytomic app does: it connects systems, models their data, and runs ETL, Reverse ETL and general syncs between them, on a schedule or on demand. You can push updates to systems, pull from them, or both. You can also provision and populate Harbors: governed data environments where AI agents securely query and act on data from your systems or your customers’ systems.

Supported systems include data warehouses, databases, cloud apps (Salesforce, NetSuite, etc), cloud storage (S3, Azure Blob, SFTP, etc), spreadsheets, and general HTTP APIs. This includes syncing updates from user-defined custom queries for systems that support querying (e.g. SQL, Salesforce SOQL, MongoDB, etc).

Two ways to use the API

Polytomic Connect,
for your customers
For your own data
What you buildData integrations inside your product: your customers connect their own systems, and you sync data to and from themAutomation for your own Polytomic workspace: connections, models and syncs created from your code, scripts or Terraform
OrganizationsYours, or one organization per customer under a partner accountYour organization
Users and permissionsProvision users for each customer, with access scoped by RBAC policiesYour team, in the app
Who connects systemsYour customers, through hosted or embedded authenticationYou, in the app or through the API
Start withPolytomic Connect overviewQuickstart

Both use the same API, the same API keys and the same API reference.

Native clients and MCP

Besides REST endpoints, Polytomic also offers native clients and a Polytomic MCP server for LLM agents and other MCP-compatible tools.

API reference

See the API reference for every endpoint. Polytomic also provides a complete OpenAPI specification and working code examples in several programming languages.

Before coding with an LLM, please instruct it to read the pages listed here: LLMs.txt.

Large-data support

Polytomic is designed to automatically scale when handling large datasets, whether it’s efficiently loading updates into a data warehouse or automatically respecting rate limits, backoff requirements, and bulk operations when syncing to and from cloud apps like Salesforce, Zendesk, etc.

Security

Polytomic regularly undergoes external security audits. Please contact us at the email address below to obtain our latest SOC 2 Type II and pentest reports.

Contact us

We’re happy to receive your questions, requests, and comments. Please send them to support@polytomic.com and we’ll respond on the same day.