Embed Overview

Overview of embedding Cloutly inside your app.

Cloutly Embed lets you render the Cloutly app in your product using an iframe while your backend controls auth and tenancy through signed JWT claims.

Core flow

1. Your frontend requests an embed JWT from your backend.

2. Your backend signs a short-lived token with your Cloutly signing key.

3. Cloutly validates the token, then upserts user and business records.

4. The iframe session loads in the scoped business context.

Required JWT claims

• externalUserEmail

• externalBusinessId

• businessDisplayName

• firstName

• lastName

• role

• smsLimits

• iat

• exp