Blueprint API - Qwilr for sales and marketing automation

With our Blueprint API, you'll be able to mass-produce personalized Qwilr Pages from a CSV upload.

Note: If you're using HubSpot or Salesforce, please use those links to find out how Blueprints work with those integrations.

Creating a CSV

Step 1. First, build a spreadsheet with the client data you’d like to include in your Qwilr Pages. The names of your spreadsheet columns should be the same as the custom fields you'll be using in your Blueprint template. (See below for more on custom fields.)

Step 2. When your spreadsheet is ready, export it as a CSV file.

Creating a Blueprint template

Step 3. Create a Qwilr Page and add your custom fields to the content. The custom fields need to be wrapped in two sets of curly brackets. like this {{   }}. They have to exactly match the column names in your CSV file.

For example, if you have a column in your CSV named companyName, the custom field you’d add to your Qwilr Page would be {{companyName}}.

Tip: It's a good idea to include one of your custom fields in the page title, as shown above. That way, when you create Qwilr Pages in bulk from your template, each page will have a unique title and it's much easier to tell them apart. If you don't use a custom field in the template title, every page you create from it will have the exact same title.

Creating Qwilr Pages in bulk 

Step 4. Once the CSV and the Blueprint template are done, you're ready to create Qwilr Pages in bulk. There are 2 ways to upload a CSV to Qwilr:

Method 1: On your dashboard, locate your template and click the More Actions icon (3 dots). Then choose Create Blueprint from the drop-down menu.

Method 2: Alternatively, you can open the template page and click on the Page Options icon (three dots) in the top right corner. Then select Blueprint.


Step 5. You'll see a box pops up. Select Spreadsheet CSV.

Step 6. Click Upload CSV and choose the CSV file from your computer. You will then be able to preview the results. If everything was done correctly, you will see variables correctly match the info from the CSV.

Step 7. If everything looks correct, click Build Projects. You will also be able to see how many Qwilr Pages will be built as a result.

Note: You can build up to 500 Qwilr Pages at a time.

Downloading a CSV with links

You'll see the display on this page update once the pages have been created. Now, you'll be able to download a CSV that contains links to every Qwilr Page that was built.

Browsing the pages you've created

To browse the pages that were created, you can click on the Explore Projects button.

Alternatively, you can hover the Blueprint's title on your dashboard to reveal the View Children button. Click it to see a list of all the pages that were created from this template. You will then be able to click into each separate page to edit it, or use the search bar to look for a specific page.

Still need help? Contact Us Contact Us