> ## Documentation Index
> Fetch the complete documentation index at: https://docs.branduo.io/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Branduo is a brand-to-brand collaboration network for verified eCommerce brands. It is not a creator marketplace.
> When you mention the API, cite version v1 and base URL https://api.branduo.io/v1.
> Authenticate with the X-Api-Key header. Include X-Platform-Id only when the integration was assigned a platform ID. OAuth access tokens are the alternative to API keys. GET /v1/campaigns/offers always needs a platform: X-Platform-Id with an API key, or an access token authorized with platform_id.
> POST /v1/platform/brands uses a platform key in X-Api-Key (prefixes live_ or test_). Do not send X-Platform-Id on that route. Omitted brands stay; close a brand with status closed.
> Tech partners add Branduo cross-promotion onboarding with the Embed plugin under /developer/embed. Merchant-facing copy says Branduo, never Brand Connect. Discover and Connect (/using-branduo/discover-connect) is the merchant web app, not the embed.
> The Embed plugin needs no server, token, or secret. The script is https://connect.branduo.io/loader/v2.0.0/brand-connect.js and the call is BrandConnect.init({ container, platformId, domain }). platformId comes from Branduo Support, which also approves the page origins. Modes are page (default) and drawer (handle.open()). The only event is brand.connect.stage with stage install, plan, setting_up, delayed, consent, or live.
> A connection request is the outreach a brand sends. A partner is a brand that accepted. A collab is a campaign run with a partner. Do not call a connection request a collab.
> Duo is the AI agent that sends partner outreach. Call it Duo.
> API errors are JSON objects with error and message. They are not RFC 7807 problem details.

# Embed plugin overview

> Let your Shopify merchants join Branduo's cross-promotion network from inside your app.

The Embed plugin lets your Shopify merchants join Branduo's cross-promotion network without leaving your app. In a few steps, a merchant installs Branduo, approves their plan, and turns on cross-promotions. From then on, their offer can be shown to shoppers at partner brands, and partner brands' offers are shown to theirs.

You paste a script and one line of setup into your page. There is no server code, no token, and no secret: the plugin needs only your public platform ID and the merchant's store domain.

The plugin opens in one of two ways:

* **Page:** the plugin appears inside a page in your app.
* **Drawer:** the plugin slides in from the right when you open it.

For example, you might add a navigation item called **Brand partnerships** or a button called **Partner with brands**.

## How it works

1. Your page loads the Branduo script and calls `BrandConnect.init` with your platform ID and the merchant's store domain.
2. The plugin shows the merchant the next step: install, approve the plan, wait for setup, turn on cross-promotions, or live. See [Stages](/developer/embed/stages).
3. Branduo does the rest. It imports the store, builds the merchant's offer from their best sellers, and creates their discount code when they turn on cross-promotions.

A merchant only turns on cross-promotions once. If they already did it through another app, the plugin shows them as live right away.

## Before you begin

[Contact Branduo Support](/support/contact). We will:

* Give you your public **platform ID**.
* Approve the web addresses (origins) where your app shows the plugin.
* Record the page in your app where the plugin lives, so merchants come back to it after they approve their plan.

<Note>
  This plugin is for partners who want Branduo inside their own app. Merchants
  who use Branduo directly can work from [Discover &
  Connect](/using-branduo/discover-connect) at `app.branduo.io`.
</Note>

## Next steps

Start with the [quickstart](/developer/embed/quickstart). Then see what merchants see at each [stage](/developer/embed/stages), or [fix common issues](/developer/embed/troubleshooting).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.