# Supaglue

> Supaglue was an open-source unified API for B2B SaaS product integrations: one CRM, engagement,
> ticketing, enrichment and marketing-automation contract projected across 30+ third-party providers
> (Salesforce, HubSpot, Pipedrive, Outreach, Salesloft, Zendesk, Apollo and more), with managed OAuth,
> managed syncs into a customer's own warehouse, and a management API to configure it all.
> **The service is retired.** The GitHub repository was archived by its owner on 2024-03-10, the
> hosted hosts api.supaglue.io and app.supaglue.io no longer resolve, and supaglue.com now redirects
> to a HugeDomains sale listing. The MIT-licensed code can still be self-hosted. Nothing below is
> callable against a Supaglue-operated endpoint; it is the historical contract, preserved because the
> unified-API model it encodes is still worth reading.

Generated by API Evangelist from the archived first-party sources. Method: generated (the docs host
that would have served /llms.txt is gone). Date: 2026-08-13.

## Status

- Repository: https://github.com/supaglue-labs/supaglue (archived 2024-03-10, MIT, last commit 2024-02-15)
- Last release: v0.25.2 (2023-12-13); last tag v0.25.7, the version stamped in every OpenAPI
- Hosted API base: https://api.supaglue.io/{service}/v2 — NXDOMAIN as of 2026-08-13
- Legal entity named in the published terms: Supergrain, Inc.

## APIs

Nine first-party OpenAPI documents, all v2, all authenticated with a single `x-api-key` header.

- [Unified CRM API](https://github.com/supaglue-labs/supaglue/blob/main/openapi/v2/crm/openapi.bundle.json): accounts, contacts, leads, opportunities, users, lists, custom + standard objects, associations, properties — 47 operations
- [Management API](https://github.com/supaglue-labs/supaglue/blob/main/openapi/v2/mgmt/openapi.bundle.json): customers, connections, providers, destinations, schemas, entities, sync configs, syncs, sync runs, magic links — 50 operations, OpenAPI 3.1 with 9 native webhooks
- [Unified Engagement API](https://github.com/supaglue-labs/supaglue/blob/main/openapi/v2/engagement/openapi.bundle.json): accounts, contacts, users, mailboxes, sequences, sequence states — 25 operations
- [Unified Ticketing API (Preview)](https://github.com/supaglue-labs/supaglue/blob/main/openapi/v2/ticketing/openapi.bundle.json): tickets, comments, attachments, collections, teams, tags — 23 operations
- [Data Listing API](https://github.com/supaglue-labs/supaglue/blob/main/openapi/v2/data/openapi.bundle.json): provider-native listings for Salesforce and HubSpot — 4 operations
- [Metadata API](https://github.com/supaglue-labs/supaglue/blob/main/openapi/v2/metadata/openapi.bundle.json): standard/custom objects and properties — 3 operations, two of them deprecated
- [Unified Marketing Automation API](https://github.com/supaglue-labs/supaglue/blob/main/openapi/v2/marketing-automation/openapi.bundle.json): forms, form fields, form submission — 3 operations
- [Unified Enrichment API](https://github.com/supaglue-labs/supaglue/blob/main/openapi/v2/enrichment/openapi.bundle.json): enrich person — 1 operation
- [Actions API](https://github.com/supaglue-labs/supaglue/blob/main/openapi/v2/actions/openapi.bundle.json): passthrough to the native provider API with managed credentials — 1 operation

## How a call is shaped

- `x-api-key: <application key>` — required on every request
- `x-customer-id` and `x-provider-name` — required on every unified call; they choose whose stored
  credential is used and which SaaS it reaches. There is no default provider.
- Cursor pagination everywhere: `?cursor=&page_size=`, response `{pagination:{next,previous,total_count}, records:[...]}`
- Incremental reads: `modified_after` / `modified_before` / `created_after` / `created_before`, ISO 8601, URI-encoded
- Freshness switches: `read_from_cache` (warehouse vs live provider), `include_raw_data`, `include_deleted_data`
- Errors: `{"errors":[{id,detail,title,code,status,meta}]}` — NOT RFC 9457. HTTP 499 means the upstream
  SaaS rejected the call and its message is passed through.
- No `Idempotency-Key`. Safe retries are the explicit `_upsert` operations.

## Specs

- OpenAPI (9 services): openapi/_original/supaglue-*-api-openapi.yml
- Per-resource OpenAPI (35 files): openapi/supaglue-*-api-openapi.yml
- Webhook catalog (9 events, from the OpenAPI 3.1 `webhooks:` block): asyncapi/supaglue-webhooks.yml
- Data model: data-model/supaglue-data-model.yml
- Error catalog: errors/supaglue-problem-types.yml
- Conventions: conventions/supaglue-conventions.yml
- Authentication: authentication/supaglue-authentication.yml
- Lifecycle and retirement: lifecycle/supaglue-lifecycle.yml
- Conformance and the historical SOC 2 claim: conformance/supaglue-conformance.yml
- Agent skills: skills/_index.yml

## Docs (all in the archived repository)

- [API introduction, auth and error codes](https://github.com/supaglue-labs/supaglue/blob/main/docs/docs/api/introduction.mdx)
- [Managed authentication](https://github.com/supaglue-labs/supaglue/blob/main/docs/docs/platform/managed-auth.mdx)
- [Notification webhooks](https://github.com/supaglue-labs/supaglue/blob/main/docs/docs/platform/notification-webhooks.md)
- [Passthrough](https://github.com/supaglue-labs/supaglue/blob/main/docs/docs/platform/passthrough.md)
- [Quickstart](https://github.com/supaglue-labs/supaglue/blob/main/docs/docs/quickstart.mdx)
- [Security](https://github.com/supaglue-labs/supaglue/blob/main/docs/docs/security_legal/security.md)
- [Terms](https://github.com/supaglue-labs/supaglue/blob/main/docs/docs/security_legal/terms.md) ·
  [Privacy](https://github.com/supaglue-labs/supaglue/blob/main/docs/docs/security_legal/privacy.md)

## What does not exist

No MCP server, no A2A agent card, no AsyncAPI document, no GraphQL surface, no first-party SDK on any
package registry, no CLI, no sandbox or test mode, no status page, no deprecation policy, and no
served `/.well-known/*` document. Every `/.well-known/` and `/llms.txt` probe against a Supaglue host
on 2026-08-13 either failed to resolve or returned a parked-domain HTML page under HTTP 200.