Skip to content
  • There are no suggestions because the search field is empty.

Embed a Paubox form in your own website or app

Paubox Forms supports a public API endpoint that returns a form's full definition. You can use the response to render the form inside your own website, app, or patient portal, and style it to match your brand.

The endpoint doesn't require an API key. You only need the form's ID, which Paubox provides in your dashboard.

What this enables

  • With the form's definition in hand, you can:

  • Render a Paubox form in your own site, app, or portal instead of sending users to a Paubox-hosted page

  • Customize the form's HTML and CSS to match your brand

  • Keep submission storage, notifications, and signable workflows hosted in Paubox

Setting this up takes some technical work. Most customers coordinate with a web developer, in-house engineering team, or a contractor.

 

Step 1: Find your form ID

  1. Log in to your Paubox dashboard

  2. Navigate to Paubox Forms

  3. Open the form you want to embed

  4. Copy the form's ID from the URL


Note: The form ID is a UUID. You'll need it for every API call.

 

Step 2: Fetch the form's definition

Send a GET request:

GET https://next.paubox.com/public/form_data/{form_id}

The response includes the form's:

  • Title and description

  • HTML markup

  • JSON schema (the structured field definition)

  • CSS styling

  • Active status, submission count, and version

Your developer can render the form as-is, override the CSS to match your brand, or rebuild the markup from the JSON schema for full control over the user experience.

 

Step 3: Accept submissions

Once your embedded form is live, you'll need to send each response back to Paubox so it's stored securely and triggers any notifications you've configured. For that, see Submit Paubox form responses via API.

 

Where to find full developer documentation

Complete reference, request and response schemas, and example payloads are at docs.paubox.com/forms/get-form.