Embeddable pages
All embed routes live under app.designa.ai/embed/* and take the same signed query parameters.
Available routes
| Route | What it opens |
|---|---|
/embed/remix | The full mini-editor, opens on Coupons. Access to the broadest set of tools. |
/embed/coupon-builder | Coupon design tool only. |
/embed/ad-builder | Ad design tool only. |
URL parameters
| Parameter | Required | Description |
|---|---|---|
partnerId | Yes† | Your registered partner slug. |
partnerUserId | Yes† | Your user's id in your own system. |
partnerBusinessId | No | Your business/team id — groups users into one shared credit pool. Omit to give the user their own solo pool. |
partnerRole | Yes† | owner, admin, or member — see role field. |
email | Yes† | Required — Designa provisions a real account for this address. |
exp | Yes† | Unix seconds the signature expires at. |
sig | Yes† | HMAC-SHA256 signature — see Authentication. |
designId | No | Reopens an existing design for editing instead of starting a new one. |
† Required for the signed flow. Origins on the legacy allowlist can omit these — see Legacy mode.
iframe attributes
index.html
<iframe
src="<signed url>"
style="width:100%;height:600px;border:none"
allow="clipboard-write"
title="Designa Workspace">
</iframe>allow="clipboard-write" lets users copy generated assets directly from the embedded workspace. A minimum height of 600px keeps the editor usable — size it to your layout above that.Reopening a design
To let a user re-edit a design they created earlier, add &designId=<id> to the signed URL. The designId comes from the DESIGNA_ASSET_CREATED event fired when they first saved it — see Receiving events. The next save updates that design instead of creating a new one.