Turtl supports embedding HubSpot forms in place of the default Turtl lead capture form. All Turtl needs is a little bit of information about your form, and this article will show you how this is done.

Before getting started:

Please make sure the integration is configured on your account before you start creating your HubSpot form. More information on how to do this here

1. Create your form and find the embed code

Create your form as usual then click the "Actions" menu in the top right-hand corner and select "Embed code"

In the popup that appears, use the "Copy" button to copy the embed code to your clipboard.

2. Find your Form ID and Portal ID

Your embed code will look something like this:

<!--[if lte IE 8]>
<script charset="utf-8" type="text/javascript" src="//js.hsforms.net/forms/v2-legacy.js"></script>
<script charset="utf-8" type="text/javascript" src="//js.hsforms.net/forms/v2.js"></script>
portalId: "1707745",
formId: "2dd13f18-f77e-43cf-9022-7359e3555f5a",
css: ""

Look for the lines that say portalId  and formId  and copy these Ids. In the example above these are:

portalId: 1707745
formId: 2dd13f18-f77e-43cf-9022-7359e3555f5a

3. Tell Turtl about your form

Navigate to the main Turtl Docs listing page and choose "Settings" for the Turtl Doc you wish to add your form to:

On the Settings page, choose the "Forms" tab:

Now paste the following URL into the "Form URL" field, replacing portalId and formId with the values you found in the previous step:


For example, with our example embed code above this would be:


The form will now display in your Turtl Doc as both the immerse form and the back cover form. If you want to display a different form for the back cover, you can specify a different URL in the "Back cover form URL" field.

4. Set your "thank you" message (optional)

The "thank you" message will be displayed when a reader has submitted the form on the back cover of your doc. By default it will just say "Thank you", but this can be changed to whatever you want. At the end of the URL you just created add the following code:


After the code, type the message that you would like to be displayed. As an example, I want to change the message to "感谢你注册!" (Thanks for signing up in Mandarin) it would look like this:


Note: If this is the first time your company has added a form to Turtl it will not have styling applied. Please contact support@turtl.co once your form has been added to a Turtl Doc and we will be able to get it styled for you.

Did this answer your question?