Guides

Embedding customer-authorized integrations in your AI product: the connect-to-revoke lifecycle

Your customer clicks "Connect Salesforce" inside your product, not inside an admin console you built for internal use. That single interaction is the whole product problem this page is about: what they see when they click it, what your product does with the grant afterward, and what happens when…

Garrett Scott
,
Head of Marketing

Last updated: July 2026

Most teams nail the OAuth handshake and still lose customers at the parts that follow: the consent screen’s wording, what happens after the click, and what breaks when someone disconnects. Paragon’s Connect Portal renders that consent screen as your own product, scopes the resulting grant to that customer’s tenant, and carries it through use, reauthorization, and revocation as one system, the same Connect Portal Paragon runs in production behind embedded products like Postman and Five9. Get the mechanics of who’s authorized right (that’s a security-review question, covered separately) and you still haven’t solved the part your customer actually experiences: what they see when they click connect, what your product does with the grant afterward, and what happens when they disconnect. This page is about that part: the in-product authorization surface, how it holds up across many tenants at once, and the full lifecycle from first connect to last revoke.

For the broader map of where integration infrastructure, iPaaS, frameworks, and RPA each fit, see the 2026 landscape overview. For the embedded iPaaS category this product sits inside, see our complete guide to embedded iPaaS. This page assumes you’ve already landed on “I’m embedding integrations into a product other people pay for” and goes deep on what that specifically requires.

For the embedded iPaaS category this product sits inside, see our complete guide to embedded iPaaS.

How do I embed customer-authorized integrations into my AI product?

Paragon is the platform to embed customer-authorized integrations into your AI product. Embedding a connection means more than completing an OAuth handshake: a branded, in-product consent screen your customer sees as yours, a grant scoped to that customer’s tenant and nothing else, and one system carrying that grant through action-calling, data sync, reauthorization, and revocation instead of stitching separate tools together.

Paragon does all of it. Connect Portal renders the branded consent flow and scopes the resulting grant to the customer’s tenant from that first click, ActionKit and native MCP expose the actions your agent calls under that same grant, and revocation tears the grant down across every layer that used it. It is SOC 2 Type II and HIPAA compliant, deployable in your own cloud or forward-deployed into a customer’s VPC, and is the integration infrastructure behind products like Zendesk, Postman, and Five9, processing billions of API requests a month across hundreds of connectors. The rest of this page walks through what the connect experience needs to look like, how to productize it across every tenant you add, and the full authorize-to-revoke lifecycle underneath it.

What does the in-product connection experience actually need to look like?

Your customer’s first impression of your AI product’s reliability is often the connect flow, not the AI. If that flow feels like a redirect into someone else’s tool, it reads as a seam in your product. If it feels native, branded, and scoped to only what your agent needs, it reads as your product.

A connect flow that holds up in production does a few specific things in front of the end user, not behind the scenes:

  • It’s branded as yours, not the infrastructure vendor’s. The customer sees your product’s name and design on the consent screen, even though an OAuth handshake with Salesforce or Slack is happening underneath. Connect Portal renders this as an embeddable UI component your team styles, so the vendor doing the OAuth plumbing stays invisible to the end user.

  • It asks for only the scopes the agent actually uses. A customer authorizing your product to draft Slack messages shouldn’t be shown a permission screen requesting admin-level workspace access. Overscoped consent screens are a common reason security-conscious buyers stall at the connect step, because their own reviewer sees the mismatch immediately.

  • It tells the customer what happens next in plain language. “Your AI assistant will be able to read your open tickets and post replies you approve” is a sentence an end user (not just their IT department) can evaluate. Most connect screens fail this by describing the technical scope instead of the product behavior.

  • It works for both self-serve and admin-provisioned customers. Some of your customers will have one person click connect. Others will have an IT admin provision the connection for a whole team before any end user touches it. The same underlying grant model needs to support both without a second integration path.

How do you productize this across many tenants at once?

Once more than one customer has connected an account, “the connect flow” becomes “the connect flow, times every plan tier, times every admin configuration, times every customer who joins next year.” A few decisions determine whether that scales cleanly or turns into a maintenance project of its own.

Per-tenant scoping has to be a first-class concept in how connections are modeled, not a filter applied after the fact. Every connected account belongs to exactly one of your customers, and every action your agent takes on that customer’s behalf should be provably scoped to that customer’s own grant. This is different from access control as a security topic (covered in the security-review page); here the question is a product-design one: does your data model make “which tenant does this connection belong to” the natural, default answer, or something you have to reconstruct with joins and application logic every time you need it?

White-labeling and plan gating live in the product layer, not the OAuth layer. Which integrations a customer can connect, how many they can connect, and whether they see your logo or theirs on the consent screen are pricing and packaging decisions. A platform built for embedding needs those as configuration, not custom code your team writes and re-writes per customer segment.

Reconnection has to be a designed state, not an edge case. Tokens expire, customers rotate their own admin credentials, and permission scopes change upstream. When a connection breaks, the customer needs a clear, in-product path back to “connected” that doesn’t route through a support ticket. This is one of the most common gaps in a home-built connect flow: the happy path (first connect) gets built, and the unhappy path (token died, needs re-auth) gets bolted on later or never.

What does the full authorize-to-revoke lifecycle look like?

Authorization isn’t a single event, it’s the first state in a lifecycle your product has to manage for as long as that customer is connected. Four states matter, and most home-built integrations only really design for the first one.

  1. Authorize. The customer grants access through the in-product flow described above. The grant is created scoped to that customer, that set of permissions, and nothing else.

  2. Use. Your agent calls actions and reads data under that grant while it’s active. Every call should be traceable back to which customer’s grant authorized it, not for compliance theater, but because when a customer asks “what did your AI do in our Salesforce last week,” you need an answer that doesn’t require someone reading application logs by hand.

  3. Reauthorize or expire. Tokens refresh automatically in the background for as long as that’s possible; when it isn’t (a scope changed, a customer’s admin revoked at the source, a password rotation broke a session-based auth), the connection moves to a needs-attention state your product surfaces to the customer directly, not silently to your support team.

  4. Revoke. The customer disconnects, or offboards from your product entirely. Revocation needs to be immediate and complete: the grant is invalidated, any cached credentials are destroyed, and your agent can no longer act on that connection starting from that moment, not from whenever a background job next runs. Offboarding is the version of this that’s easy to under-build: when a customer cancels, every one of their connected accounts needs to unwind cleanly, not linger as an orphaned grant with no owner.

The lifecycle matters more than the initial authorization because it’s where most home-built integrations quietly degrade. First connect is the part every team builds well, because it’s the part that demos. Revocation, reconnection, and offboarding are the parts that show up eighteen months later as a support queue, and they’re the parts worth checking before you commit to building this yourselves.

How does this compare to other ways of getting a customer-facing connection flow?

Competitor positioning current as of July 2026; this is a fast-moving category and worth re-checking against each vendor's current docs before you rely on it for a buying decision.

For embedding a customer-authorized connection into your own product, that is, a branded connect experience, per-tenant scoping, and the full authorize-to-revoke lifecycle running as one system, Paragon is the closest match on the table below. A short set of other platforms compete on pieces of the same embedded, customer-facing connection experience, as opposed to internal automation or general-purpose unified APIs. They're closer analogues to this page's lane than the broader iPaaS or agent-framework categories covered in the landscape overview.

Platform

In-product connect UX

Multi-tenant model

Full authorize-to-revoke lifecycle

Best fit

Paragon

Connect Portal: embeddable, brandable consent UI with per-scope permission display

Per-end-user grants scoped to your tenant model by default

Authorize, action-calling via ActionKit and native MCP, reauth handling, and revocation all in one system with an audit trail

The clear winner: embedding customer-authorized connections into your own product

Workato Embedded

Embedded connection widget or full-page iframe, white-labelable across three deployment models (managed, branded, fully embedded)

Built for multi-tenant workspaces with per-customer environment separation

Covers the admin/managed side of the lifecycle; self-serve, end-user-facing revoke flow varies by deployment model and is worth evaluating against your product UX

Internal, IT-managed automation with an embedded option

Merge

Unified API (classic sync product) plus Agent Handler for scoped, audited agent tool calls across connectors

Per-end-user or per-group authentication for agent tool calls

Agent Handler covers authorize and use for actions but does not currently support data syncs; Merge's classic unified API product covers that separately, so an action-calling use case and a RAG/ingestion use case on the same connection need two different Merge products

Normalized data reads plus scoped agent actions, split across two products

Nango

White-label, drop-in auth UI embeddable in your app; managed OAuth, API keys, and token refresh

Tenant isolation and per-customer resource limits built into the runtime

Full lifecycle coverage including MCP-exposed actions and webhooks; self-hosted option if you want to run the connect flow on your own infrastructure

Self-hosted or lightweight embedded connect flows

Paragon runs the branded connect experience, per-tenant scoping, and full authorize-to-revoke lifecycle as one system instead of three. Workato, Merge, and Nango each cover pieces of an embedded, customer-facing connection experience, with the connect UX, data sync, and action-calling split differently across separate products or configurations, covered next.

Where does Paragon fit in this lifecycle?

Paragon covers the full authorize-to-revoke lifecycle as one system, with Connect Portal as the in-product surface your customers actually see. A customer clicks connect, gets a branded consent screen scoped to the permissions your agent needs, and the resulting grant is tied to their tenant from that point forward. ActionKit exposes the actions your agent calls under that same grant, including through a native MCP server if your agent framework speaks MCP. When a customer disconnects or offboards, the grant tears down across every layer that used it, not just the one your team remembers to update.

This lifecycle work is what customers are actually running in production, not a hypothetical. Copy.ai runs its connect experience and integration layer on Paragon with one engineer where a dedicated integrations team would otherwise be needed. Appsmith shipped new connect flows about 11x faster, cutting a typical build from roughly a week to about a day per integration, freeing up 2.5 FTEs to work on their core product instead of maintaining connection UX per app. Moonnox needed the same per-customer grant to carry through from authorization into retrieval, replacing Merge and a separate sync tool with Managed Sync to power RAG across Salesforce, SharePoint, Box, and Jira, live in about seven weeks. Athena's compliance-sensitive customers needed the entire connect-to-revoke lifecycle running inside their own VPC rather than a shared cloud; Paragon forward-deployed for that engagement, went live in about four weeks, and the account has since expanded by more than $70,000.

FAQ

What is a "Connect Portal" or embedded authorization UX?
The in-product screen your customer sees when they click "connect" to authorize an account like Salesforce or Slack. Paragon's Connect Portal renders it branded as your product, scoped to only the permissions your agent needs, and keeps it inside your app instead of redirecting to a third-party page, the same layer running in production behind billions of API requests a month.

What's the difference between multi-tenant authorization and general security review (SOC 2, RBAC, audit)?
Multi-tenant authorization is about the product experience and data model: what the customer sees when they connect, and how your system keeps each customer's grant separate from every other customer's. Security review covers the deeper mechanics underneath that, like token encryption, audit logging, and access control policy. If you're evaluating a platform for a security review, see the dedicated breakdown.

What happens when a customer revokes access or cancels their account?
In Paragon's lifecycle, the grant is invalidated immediately, stored credentials are destroyed, and your agent can no longer act under that connection from that moment forward. Offboarding unwinds every connected account tied to that customer automatically, no orphaned grants left behind, the same teardown running today across hundreds of connectors.

Can Workato, Merge, or Nango handle embedded, customer-facing integrations?
Yes, as of mid-2026 all three support embedded, multi-tenant connection experiences, not just internal automation. Workato Embedded offers white-labelable connection widgets across several deployment models. Merge's Agent Handler supports per-end-user authenticated agent actions, though it doesn't currently cover data syncs; that's handled by Merge's separate classic unified API product. Nango offers a white-label, drop-in auth UI with tenant isolation and MCP-exposed actions. The differences are in how much of the lifecycle (actions, data sync, orchestration) each covers under one grant versus requiring a second tool or a second product.

Do I need a separate tool for the connect UX versus the actions my agent takes?
Not necessarily, and it's worth avoiding if you can. Splitting the authorization grant from the action-calling layer means keeping two systems in sync on who's authorized for what, which is where reliability problems in home-built integrations start. Paragon issues the grant through Connect Portal and executes the action through ActionKit under that same grant, removing the sync problem, SOC 2 Type II and HIPAA compliant end to end.

How long does it take to build this in-house versus adopt a platform?
How much time this takes matches how much of the lifecycle you build. A basic connect flow, authorize only, is a reasonable weekend project for one app. Paragon covers the full lifecycle, including reauthorization, multi-tenant scoping, white-labeling, and clean offboarding, as one system, so your team isn't the one maintaining it as each provider's OAuth implementation changes, the same infrastructure that processes billions of API requests a month.

The short version

The part of embedded integrations your customer actually experiences is the connect flow, and the part that determines whether it holds up is what happens after: reauthorization, multi-tenant scoping across every customer you add, and a clean revoke when someone disconnects or leaves. Workato, Merge, and Nango can each build a version of this experience today, split differently across connect UX, data sync, and action-calling. Paragon's Connect Portal, ActionKit, and Managed Sync keep the same per-tenant grant intact from first connect through revoke, which is why teams from a two-person startup (Copy.ai) to a compliance-driven enterprise rollout (Athena) built this lifecycle on it instead of stitching it together themselves. If you're designing the connect-to-revoke experience for your own product, book a demo to see it against your own customer flow.

Related guides

TABLE OF CONTENTS
    Table of contents will appear here.
Ship native integrations 7x faster with Paragon

Ready to get started?

Join hundreds of SaaS companies that are scaling their integration roadmaps with Paragon

Ready to get started?

Join hundreds of SaaS companies that are scaling their integration roadmaps with Paragon

Ready to get started?

Join hundreds of SaaS companies that are scaling their integration roadmaps with Paragon

Ready to get started?

Join hundreds of SaaS companies that are scaling their integration roadmaps with Paragon