Skip to Content
Browse docs

Maintained by

SaaS integration overview

Use Connector for SaaS when each user of your product needs to authorize their own Gmail, Slack, Notion, or another provider account. Your product owns the user experience and user mapping; OOMOL Connector stores the connected account and executes actions requested by your backend.

This path uses a project API key shaped like oo_proj_…. The key represents one Connector project and stays on your backend.

Resource model

ResourcePurpose
ProjectIsolates provider configs, keys, connected accounts, logs, and usage
Provider configDefines how one provider is authorized inside the project
External user IDMaps connected accounts to a user in your product
Connected account ID or aliasSelects the account used for an action
Project API keyAuthenticates requests from your backend
Project webhookReceives signed connection and Trigger events on your backend
Trigger subscriptionWatches a connected account and sends new provider events to your webhook

Integration flow

  1. Create a project and provider config in OOMOL Console.
  2. Create a project API key and store it in your backend secret manager.
  3. Ask your backend to create an authorization link for an external user.
  4. Send the user through the provider authorization flow.
  5. Save the returned connected account ID or alias beside your product user.
  6. Execute actions from the backend for that user and account.

Responsibilities

Your product authenticates its users, decides which provider they can connect, stores the user-to-account mapping, and controls which actions its backend requests. Keep the project API key out of browsers and mobile clients.

OOMOL Console provides project configuration, connected-account records, execution logs, and usage views for this integration path.

Start building

Use the Connector for SaaS guide for Console setup and the REST flow. Use Connect end-user accounts with ProjectConnector when your backend is written in TypeScript. To react to account connections or provider events, read Receive project webhooks and Receive provider events with Triggers.

Your everyday apps, now for your AI

Let your AI find emails, read documents and look through code in the apps you already use.