The Embeddable Builder API enables you to seamlessly integrate Docue's document-building interface into your own platform, offering your users a smooth document creation experience - entirely within your branded environment.
Please note that this is a separate product from Docue.com platform. If you are a user of Docue.com and are interested in integrating it into your system, please visit our Platform API Documentation. The EB API is primarily designed for system providers or resellers looking to integrate Docue's document-building features into their existing products.
Example implementation can be found at https://example-embeddable-builder.vercel.app. It demonstrates example flows from the end user's perspective on how the EB works.
To use this API, you need an API key. You can generate sandbox and production API keys in the customer portal at https://api.builder.docue.com/customer.
Sandbox and production API keys operate within the same API. All created resources are automatically isolated into separate environments. You cannot access production data using a sandbox API key or vice versa. Using a sandbox API key does not count toward your account limits and does not incur any costs.
If you do not have access to the customer portal yet, please contact our customer support at eb-support@docue.com.
The core of EB is the Builder. The Builder is a hosted UI to which you redirect your end-users. To start using the Builder, you need a template. You can allow your end-users to choose a template using our hosted Template Browser, or you can create your own customized template browser UI using our API.
What is template?
Template is our proprietary format for defining a set of questions and logic to generate highly customizable and trustworthy legal documents. Each template belongs to one or more jurisdictions (usually just one as legal requirements differ across them), and can be available in multiple languages. For example, the Finnish Employment Agreement template is available in three languages: Finnish, English, and Swedish. The end-user can choose which language version they want to draft.As part of your account setup, we can choose which templates are available via the API and via the Template Browser.
To use the Template Browser, you must create a new browser session. Then, redirect your end-user to the provided URL. Once the end-user selects their template, they will be redirected back to the return URL you provided. In most cases, you will then immediately start a new Builder session using the provided data and redirect the user back to our UI.
To use the Builder, you must create a new builder session. Then, redirect your end user to the provided URL. Once the end user completes the document, they will be redirected back to the return URL you provided. After that, you can fetch the completed PDF and metadata, including the list of signees, using the API.
Once the drafting UI redirects back to your service you can manage the document lifecycle via the Builder endpoints:
GET /api/builder/sessions/{session_id}/contractto fetch the latest contract state.POST /api/builder/sessions/{session_id}/contract/finalizeto lock the document when it is ready.GET /api/builder/sessions/{session_id}/htmlorGET /api/builder/sessions/{session_id}/pdfto retrieve the rendered output.
You can upload your logo using the Customer Portal, and it will be displayed in the Template Browser and Builder UIs for all sessions.
Documents are stored on our servers only for the necessary duration. All Builder sessions and their related data will be completely removed from our servers once the session is deleted or completed. We do not offer long-term storage for created documents or their attachments.
We do not recognize your end users in any way. The only exception is that for collaboration features, we may require the display name or email of the end user for user experience reasons. Therefore, it is your responsibility to manage permissions for templates and documents among your end users. We provide one system-level API key to authenticate against our API, which grants access to all currently active builder sessions. The authenticated session in our UI is always restricted to one browser session or one document at a time.
- Collaboration. You can add multiple participants to the same Builder session, allowing them to collaborate on the document in real time.
- Builder session restoration. You can save the builder session along with all necessary data and then use that data to open a new builder session. This feature can be utilized for duplicating previously created documents or for implementing long-term storage for unfinished documents.
- Webhooks. Receive real-time updates to documents without the need for polling.
If you need any of the features coming later, please don't hesitate to contact us at eb-support@docue.com and describe your use case.
With document patch api you can manipulate document's state and appearance using API. Please get used to Get contract state endpoint before continuing.
Key Features:
- Batch Updates: You can perform multiple operations in a single request.
- Sequential Execution: Operations are applied in the order they are defined (top to bottom).
- Appearance Updates: Easily customize fonts, logos, and footers.
- Document Value Updates: Modify contract content, such as document name and any field value.
- Realtime updates: If the end user has the builder UI open, all changes will be reflected in their view in real time.
Document name functions as a file name. It appears in the builder UI and can be edited by the end-user. Although it is not directly displayed in the document, it is used as the PDF filename when exported. Note that this is distinct from /value/basic/title, which refers to the title visible on the document itself.
PATCH /api/builder/sessions/{session_id}/contract
{
"operations": [
{
"op": "replace",
"path": "/document_name",
"value": "Share Purchase Agreement, Hooli Inc."
}
]
}The value property in the state serves as the source of truth for all field values in the contract. In its simplest form, it appears as follows:
{
"basic": {
"_type": "value",
"_id": "01983d68-40a7-8dd9-b97e-15ffe908ad2a",
"title": "Share Purchase Agreement"
},
"parties": [
{
"_type": "value",
"_id": "01983d68-40a7-8dd9-b97e-15ffe908ad1b",
"type": "company",
"company_name": "Docue",
"company_id": "1212",
"first_name": "Doe",
"last_name": "John",
"job_title": "CEO"
}
],
"fieldset_x": {
"_type": "value",
"_id": "01983d68-40a7-8dd9-b97e-15ffe908ad3c",
"nested_fieldset_y": {
"_type": "value",
"_id": "01983d68-40a7-8dd9-b97e-15ffe908ad3d",
"field_z": 1212
}
}
}The schema of the value depends on the template used, and each template has a different schema. The template defines the schema and cannot be altered at this stage.
The value consists of fieldsets and fields. All root-level properties are the names of fieldsets. A fieldset is a collection of fields. It can be "repeatable," meaning it can contain multiple values; in practice, its value is an array of objects. In the example above, the basic fieldset is non-repeatable, while the parties fieldset is repeatable. The template can define the minimum and maximum number of instances a fieldset can have.
A fieldset contains fields. A field is typically a single HTML element in the user interface. The type of value depends on the field type. A field can define validation rules, such as whether the value is required and the length of certain text.
Fieldsets can also include nested fieldsets, but only three levels of nesting are supported (two fieldsets and one field).
With patch operations, you can replace entire fieldset values, add new fieldset instances, remove existing fieldset instances, and modify any field value.
Tip: If you want to add a new item at the end of the fieldset value, use the path /value/parties/-.
Note: Currently, it is not possible to replace attachments via the API. Please contact us if you need this feature.
PATCH /api/builder/sessions/{session_id}/contract
{
"operations": [
// Add new party
{
"op": "add",
"path": "/value/parties/-",
"value": {
"_type": "value",
"_id": "01983d68-40a7-8dd9-b97e-15ffe908ad1f", // Generate UUIDv7 for new values
"first_name": "Doe",
"last_name": "John"
}
},
// Remove first party
{
"op": "remove",
"path": "/value/parties/0"
}
// Update name of the first party
{
"op": "replace",
"path": "/value/parties/0/first_name",
"value": "Johnny"
}
]
}Document appearance, such as typography styles, logo and footer can also be updated via API. Pass the whole appearance object at once.
PATCH /api/builder/sessions/{session_id}/contract
{
"operations": [
{
"op": "replace",
"path": "/appearance",
"value": {
"logo": {
"enabled": true,
// data URI with base64 encoding, jpg, png or svg
"content": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
"scale": 50 // logo size, scale from 20-100
},
"footer": {
"enabled": true,
"content": "Hooli Inc."
},
"heading1": {
"family": "lexend", // See supported fonts below
"color": "#000000",
"size": "20",
"weight": "bold",
"alignment": "center",
"transform": "uppercase"
},
"heading2": {
"family": "lexend",
"color": "#333333",
"size": "16",
"weight": "bold",
"alignment": "left",
"transform": "none"
},
"heading3": {
"family": "lexend",
"color": "#333333",
"size": "14",
"weight": "bold",
"alignment": "left",
"transform": "none"
},
"heading4": {
"family": "lexend",
"color": "#333333",
"size": "12",
"weight": "bold",
"alignment": "left",
"transform": "none"
},
"heading5": {
"family": "lexend",
"color": "#333333",
"size": "12",
"weight": "regular",
"alignment": "left",
"transform": "none"
},
"heading6": {
"family": "lexend",
"color": "#333333",
"size": "12",
"weight": "regular",
"alignment": "left",
"transform": "none"
},
"paragraph": {
"family": "lexend",
"color": "#000000",
"size": "11",
"weight": "regular",
"alignment": "justify",
"transform": "none"
},
"table": {
"family": "lexend",
"size": "10",
"color": "#000000",
"bgColor": "#ffffff",
"headerBgColor": "#f5f5f5",
"headerColor": "#000000",
"borderColorEnabled": true,
"borderColor": "#cccccc",
"alternatingRowBgColorEnabled": true,
"alternatingRowBgColor": "#fafafa"
}
}
}
]
}Currently supported fonts are:
arial,times-new-roman,georgia,eb-garamond,lexend,roboto,open-sans,montserrat,lato,poppins,raleway,anek,inter
We can easily support any font available in Google Fonts. Please feel free to ask if you need a font that we are not currently offering.