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

> ## Agent Instructions
> Authenticate with the raw API key in the Authorization header. Never add a Bearer prefix.
> Use the sandbox base URL https://api.test.doola.com and a dk_test_ key in examples unless the user asks for production.
> Send an Idempotency-Key header on POST /v1/partner/customers, POST /v1/partner/companies, POST /v1/partner/companies/import, POST /v1/partner/companies/{companyId}/services and POST /v1/partner/companies/{companyId}/documents. No other endpoint takes one.
> Every response is wrapped as {payload, error}. Read fields from payload and branch on error.code, never on the message.
> Drive formation progress from webhooks plus a reconciliation sweep, never a polling loop.
> Embedded SDK (@doola/js): the dk_ key stays on the server and mints customer sessions; the browser gets only a pk_ key and the session. onFormed carries only companyId and can fire more than once. Before charging, read the company with the dk_ key, require formationSubmissionStatus AWAITING_PAYMENT, check the owner's email, and price on the server. Then POST payment-confirmed, which answers 200 with an empty body, and replace the SDK element with a new doola.create() (never append a second one).
> The doola Formation MCP server at https://mcp.doola.com is for founders forming their own company with their own doola account. Platform partners integrate the Partner API or the Embedded SDK. The /mcp endpoint on this docs site only searches these docs.
> Affiliates refer founders to doola with a PartnerStack referral link and coupon code, or with two doola-branded iframe widgets: the Demo Booking Widget (app.doola.com/embed/book-demo?link=<referral link>) and the Company Formation Widget (app.doola.com/embed/partner/<partner ID>). The widgets need no API key and are not the Embedded SDK. Copy the snippets exactly as documented, never add a sandbox attribute to the formation widget iframe.
> For a full capability summary with the rules above, read https://docs.doola.com/skill.md.

# Demo Booking Widget

> Let your visitors book a free 15-minute call with doola's team without leaving your site. One snippet, your referral link, and you're live.

The doola Demo Booking Widget lets your visitors book a free 15-minute call with doola's team without leaving your site. You paste one snippet, add your referral link, and you're live. When a visitor you send books a call and becomes a doola customer within 90 days, signing up with the same email, the commission is credited to you.

Questions? Email [engineering@doola.com](mailto:engineering@doola.com).

![A sample partner page, Northstar Creators, with the doola booking widget's intro next to the partner's own headline](https://mintcdn.com/doola/TC8WMsYfU1TTGdJ4/images/affiliates/demo-booking-widget-partner-page-desktop.jpg?fit=max\&auto=format\&n=TC8WMsYfU1TTGdJ4\&q=85\&s=eaf3964abfeb820eb78431c0a5a6e07f)

The widget on a sample partner's page, desktop.

## How it works

**1. Intro**

The visitor sees a short intro and clicks to book.

**2. Their details**

They enter their name, email and country.

**3. Their topic**

They tell us what they'd like to discuss.

**4. Pick a time**

They pick a time in the calendar, and get a confirmation.

The whole flow takes under 2 minutes. It works from 320px wide (mobile) up to 740px, and with the optional script below, the widget grows its height to fit each step.

![Step 1 of 3: the widget asking for first name, last name, email and country of residence](https://mintcdn.com/doola/TC8WMsYfU1TTGdJ4/images/affiliates/demo-booking-widget-details.jpg?fit=max\&auto=format\&n=TC8WMsYfU1TTGdJ4\&q=85\&s=69decf97621c38e1f1832ad9e2014023)

Their details

![Step 2 of 3: the widget asking what the visitor would like to discuss](https://mintcdn.com/doola/TC8WMsYfU1TTGdJ4/images/affiliates/demo-booking-widget-topic.jpg?fit=max\&auto=format\&n=TC8WMsYfU1TTGdJ4\&q=85\&s=f48a073a236657f91a6df2e36789e24d)

Their topic

![Step 3 of 3: a calendar to pick a day for the 15-minute call](https://mintcdn.com/doola/TC8WMsYfU1TTGdJ4/images/affiliates/demo-booking-widget-schedule.jpg?fit=max\&auto=format\&n=TC8WMsYfU1TTGdJ4\&q=85\&s=5c150726d7a9cc8f2cdb82f811d8a0b5)

Pick a time

![The widget confirming the booking and pointing the visitor to their email](https://mintcdn.com/doola/TC8WMsYfU1TTGdJ4/images/affiliates/demo-booking-widget-confirmation.jpg?fit=max\&auto=format\&n=TC8WMsYfU1TTGdJ4\&q=85\&s=2dd9ffd21504b3af463645e2b6ab404f)

Confirmation

## Add it to your site

Paste this snippet where you want the widget to appear, and replace `YOUR_REFERRAL_LINK` with your PartnerStack referral link (for example `https://partnersps.doola.com/yourlink`). If your link has its own `?` or `&`, URL-encode it first.

```html Production theme={null}
<iframe id="doola-book-demo"
        src="https://app.doola.com/embed/book-demo?link=YOUR_REFERRAL_LINK"
        width="100%" height="900" style="border:0;min-width:320px"
        title="Book a demo with doola"></iframe>
<p id="doola-book-demo-fallback">
  <a href="https://app.doola.com/embed/book-demo?link=YOUR_REFERRAL_LINK" target="_blank" rel="noopener">
    Can't see the booking form? Book your doola demo here</a>
</p>
<script src="https://app.doola.com/embed/book-demo.js" async></script>
```

```html Sandbox theme={null}
<iframe id="doola-book-demo"
        src="https://app.development.doola.com/embed/book-demo?link=YOUR_REFERRAL_LINK"
        width="100%" height="900" style="border:0;min-width:320px"
        title="Book a demo with doola"></iframe>
<p id="doola-book-demo-fallback">
  <a href="https://app.development.doola.com/embed/book-demo?link=YOUR_REFERRAL_LINK" target="_blank" rel="noopener">
    Can't see the booking form? Book your doola demo here</a>
</p>
<script src="https://app.development.doola.com/embed/book-demo.js" async></script>
```

The sandbox uses a test calendar, so no real call gets booked.

### What each part does

* **The iframe** loads the widget. Your referral link in `link=` is how bookings are credited to you.
* **The script** resizes the iframe to fit the widget and hides the fallback link once the widget loads. It's optional: without it, the widget stays 900px tall.
* **The fallback link** opens the widget in a new tab if your site blocks the iframe.

## Requirements

* **Your page must be served over HTTPS.** The widget won't load inside an `http://` page.
* **Keep the URL as given.** Only change the `link=` value.
* **One widget per page.** The snippet uses fixed ids, so a second copy on the same page keeps its fallback link visible.
* **No doola cookies.** The widget stores nothing in your visitors' browsers. The calendar step is provided by Calendly, which shows its own cookie notice.

## Best practices

* **Give it some context.** The widget works anywhere on your page, but it converts best inside a section that tells your visitors why they should book, for example "Free for our members: a 15-minute call with doola's formation team."
* **Consider a dedicated page.** A page with a memorable URL (for example `yoursite.com/doola`) is easy to link to from emails, posts and your dashboard.

## FAQ

> [accordion] Can we change the colors or add our logo?
>
> Not yet. The widget uses doola's branding and adapts to your page's width.

> [accordion] What if we leave out the referral link?
>
> The widget still works and bookings still reach doola, but they can't be credited to you.

> [accordion] Who follows up with the visitor?
>
> doola's team runs the call and all follow-up. Nothing is needed from you.

> [accordion] Is there a spam check?
>
> Yes. A Cloudflare security check runs in the background, and visitors only see it if Cloudflare needs them to click.

> [accordion] How long does setup take?
>
> Usually a few minutes: paste the snippet, add your link, publish.


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