> ## 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.

# Company Formation Widget

> Let your visitors form a US LLC or C-Corp, pick a plan and pay, all without leaving your site. One snippet with your partner ID.

The doola Company Formation Widget lets your visitors form a US LLC or C-Corp without leaving your site. You paste one snippet with your partner ID and you're live, on any HTTPS page. Every new doola account created through the widget is credited to you.

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

![A sample partner page, Northstar Creators, with the doola signup screen embedded below the partner's own headline](https://mintcdn.com/doola/TC8WMsYfU1TTGdJ4/images/affiliates/formation-widget-partner-page-desktop.jpg?fit=max\&auto=format\&n=TC8WMsYfU1TTGdJ4\&q=85\&s=75e4297ff812958bca9c559d10c19df4)

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

## How it works

**1. Sign up**

The visitor signs up with their email or with Google. Google opens in a small popup.

**2. Five short questions**

New or existing business, LLC or C-Corp, where they live, which state, and the company name.

**3. Pick a plan and pay**

They pick a plan, review the total and pay by card, all inside the widget.

**4. Manage the company**

They finish their account and manage the company from the same widget, or at [app.doola.com](https://app.doola.com) with the same login.

The widget uses its full desktop layout from 1,024px wide, a tablet layout from 768px, and a phone layout below that, down to 320px. Its height is fixed, and the content scrolls inside it.

![The widget asking which entity fits the company: LLC or C-Corp](https://mintcdn.com/doola/TC8WMsYfU1TTGdJ4/images/affiliates/formation-widget-questions.jpg?fit=max\&auto=format\&n=TC8WMsYfU1TTGdJ4\&q=85\&s=dd56a85ed92fda2b150f6be054ebc4bc)

Five short questions

![The widget's plan choice: Starter, Tax and Compliance and Business-in-a-Box](https://mintcdn.com/doola/TC8WMsYfU1TTGdJ4/images/affiliates/formation-widget-plans.jpg?fit=max\&auto=format\&n=TC8WMsYfU1TTGdJ4\&q=85\&s=33f93f60d85de4556d2c85891e941dcd)

Plan choice

![The widget's review screen with the company details, the chosen plan and the total due today](https://mintcdn.com/doola/TC8WMsYfU1TTGdJ4/images/affiliates/formation-widget-checkout.jpg?fit=max\&auto=format\&n=TC8WMsYfU1TTGdJ4\&q=85\&s=6e7993b130a6d64e1a6856f2d693e49a)

Review and pay

![The doola dashboard for a sample customer, shown inside the widget](https://mintcdn.com/doola/TC8WMsYfU1TTGdJ4/images/affiliates/formation-widget-dashboard.jpg?fit=max\&auto=format\&n=TC8WMsYfU1TTGdJ4\&q=85\&s=736b130409228115cdca0a7fdfd5b282)

The customer's dashboard, inside the widget

## Add it to your site

Paste this snippet where you want the widget to appear, and replace `YOUR_PARTNER_ID` in both places with the ID doola sends you.

```html Production theme={null}
<iframe
  src="https://app.doola.com/embed/partner/YOUR_PARTNER_ID"
  title="doola Company Formation"
  width="100%" height="800"
  style="border:0;min-width:320px"
  allow="clipboard-read; clipboard-write"
  referrerpolicy="strict-origin-when-cross-origin"></iframe>
<p>
  <a href="https://app.doola.com/embed/partner/YOUR_PARTNER_ID" target="_blank" rel="noopener">
    Trouble with the form? Open it in a new tab</a>
</p>
```

```html Sandbox theme={null}
<iframe
  src="https://app.development.doola.com/embed/partner/YOUR_PARTNER_ID"
  title="doola Company Formation"
  width="100%" height="800"
  style="border:0;min-width:320px"
  allow="clipboard-read; clipboard-write"
  referrerpolicy="strict-origin-when-cross-origin"></iframe>
<p>
  <a href="https://app.development.doola.com/embed/partner/YOUR_PARTNER_ID" target="_blank" rel="noopener">
    Trouble with the form? Open it in a new tab</a>
</p>
```

Sandbox payments run in Stripe test mode, so pay with card `4242 4242 4242 4242`, any future date and any CVC. No real company is formed.

### What each part does

* **The iframe** loads the widget. Your partner ID in the URL is how signups are credited to you.
* **The fallback link** opens the same flow in a new tab, with the same credit. Keep it on the page: it helps visitors on Safari and iPhone (see [Known limits](#known-limits)).

## Requirements

* **Your page must be served over HTTPS.** The widget won't load inside an `http://` page, including a local `http://localhost` test page.
* **Keep the URL as given.** Only change `YOUR_PARTNER_ID`.
* **Don't add a `sandbox` attribute to the iframe.** Google sign-in needs to open its popup.
* **Give it room.** Full width of a container at least 1,024px wide on desktop, and at least 800px tall.
* **Cookies.** The widget is doola's app running inside your page, so it sets doola's cookies for sign-in, and doola's analytics and marketing tools set their own, all under doola's [Privacy Policy](https://www.doola.com/privacy-policy/). If your cookie notice lists third parties, include doola and its analytics and marketing tools.

### Known limits

* **Safari and iPhone or iPad.** These browsers block sign-in cookies inside iframes from other sites, so a visitor there can lose their sign-in inside the widget. The fallback link lets them continue in a new tab, still credited to you.
* **Account and billing changes open in a new tab.** To keep accounts safe, the widget asks the customer to open doola in a new tab to change their email or password, delete their account, remove or dissolve a company, disconnect a bank or payment account, or cancel a subscription. Signup, the formation questions, payment and company setup all work inside the widget.
* **Mobile apps.** Open the production URL directly in an in-app browser (Safari View Controller on iOS, Chrome Custom Tabs on Android) instead of placing the iframe inside a web view. Google sign-in doesn't work inside web views.

## Best practices

* **Use a dedicated page.** A clean page with a memorable URL (for example `yoursite.com/llc`) is easy to link to and return to. Avoid placing the widget inside a blog post, a sidebar or a modal.
* **Give it some context.** A short intro above the widget converts better, for example "Members get their US company formed by doola: LLC or C-Corp, EIN and registered agent included."
* **Say who does what.** A line like "Company formation powered by doola" under the widget keeps company questions with doola's support team.

## Going live

**1. Kickoff**

doola sends your partner ID.

**2. Sandbox**

Paste the sandbox snippet, then run a test signup and a test payment on desktop and on a phone.

**3. Go live**

Swap in the production snippet and publish.

Once you have your partner ID, the rest is your own testing, so you can go live the same day.

## FAQ

> [accordion] Can we change the colors or add our logo?
>
> Not in the widget. It uses doola's branding and adapts to your page's width. For a fully branded experience, see [platform integrations](https://docs.doola.com/affiliates/integrations.md#building-formation-into-your-own-product).

> [accordion] How are signups credited to us?
>
> Your partner ID is in the widget URL. Every new doola account created in the widget or through its fallback link, by email or Google, is recorded against it, and doola adds it to your PartnerStack account. Visitors who already have a doola account and log in through the widget are not credited.

> [accordion] Who emails the customer and answers their questions?
>
> doola sends all onboarding and account emails, and doola's support team handles questions about the company, EIN, registered agent and taxes.

> [accordion] What reporting do we get?
>
> Reporting is on request: visitors who entered the flow, drop-off points, companies formed, plans purchased and renewals.

> [accordion] How do we handle GDPR or CCPA deletion requests?
>
> Forward them to [bd-team@doola.com](mailto:bd-team@doola.com) and we delete all doola-held records for that person. Requests made to doola directly need no action from you. You still handle data in your own systems.

> [accordion] Does it work in mobile apps?
>
> Yes, opened in an in-app browser. See [Known limits](#known-limits).

> [accordion] Is there a public demo?
>
> No. To protect production, we share a sandbox snippet for testing, and the screenshots on this page show the main screens.

> [accordion] How long does setup take?
>
> Pasting the snippet takes minutes. Once doola has sent your partner ID, the rest is your own testing, so you can go live the same day.


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