# Cloutly Embed Overview

Cloutly Embed lets you run the Cloutly experience inside your own app while keeping your users and businesses synced from your platform.

## What You Can Build

* Embed the Cloutly app in your dashboard via iframe.
* Provision users and businesses on the fly with a signed JWT.
* Use REST APIs to read businesses and reviews, send invites, and post replies.
* Render ready-made widgets or build custom UI on top of API data.

## Two Parts, One Spec

1. **REST API**
   * Base domain: `https://app.cloutly.com/api/v1`
   * API key auth via `x-api-key`
   * Endpoints for businesses, reviews, review replies, and review invites
2. **Cloutly Embed**
   * Signed JWT from your backend
   * Claims identify the user and business context
   * Automatic upsert of user/business when the iframe session starts

## Why Teams Use Cloutly Embed

* Avoid building and maintaining review collection workflows from scratch.
* Avoid managing direct integrations for every review source.
* Ship AI-powered review insights inside your existing product UX.
* Keep account management and provisioning in your control.

## High-Level Architecture

```mermaid
flowchart LR
  yourUser[Your User] --> yourApp[Your App Frontend]
  yourApp --> yourApi[Your Backend API]
  yourApi -->|x-api-key| cloutlyRest[Cloutly REST API]
  yourApi -->|signed JWT| cloutlyEmbed[Cloutly Embed]
  cloutlyEmbed -->|iframe| yourApp
```