Skip to main content
The connect link is a plain URL. Put it behind the Connect Branduo button in your app. It needs no key and grants nothing: it tells Branduo that your platform sent this store, then sends the merchant to Shopify, where they approve your platform in the Branduo app.
Open it in the browser, as a link or a new tab. Don’t call it from your server: it answers with a redirect, not JSON, unless the IP address is rate limited.

Query parameters

string
required
Your platform ID, a UUID from Branduo Support. It is public.
string
The merchant’s store domain: their *.myshopify.com domain or their own domain, such as northwindgoods.com. Branduo drops the scheme, www., the port, and any path. Send it whenever you know it. Without it, the merchant is asked for their store name first.

Where it sends the merchant

Branduo remembers that you sent the store for 7 days. While it does:
  • Opening the Branduo Shopify app shows the merchant Run your offer on {your platform} until they choose Approve or Not now.
  • Get a brand shows you the merchant’s full stage (install, billing, approve) before they approve.
If the store installs Branduo within 24 hours of the last click on your link, Branduo also records your platform as the one that brought it. A merchant can always choose Not now. Sending the link again asks again.

Coming back to your app

After Approve or Not now, the Branduo Shopify app opens your return URL (set up with Support) in the merchant’s browser:
Query parameters already on your return URL are kept.
The return is not signed. Anyone can open your return URL with status=approved. Always confirm with Get a brand before you change anything.
Without a return URL on file, the merchant stays in the Branduo Shopify app after approving.

Limits

Branduo records at most 5 clicks per store per hour, and at most 300 per platform per minute. Clicks past those limits still redirect; they just aren’t recorded again. Separately, one IP address can open the link 120 times a minute; past that it returns HTTP 429 with the rate_limit JSON body and a Retry-After header (seconds left in the window) instead of redirecting.