Connect Simpro and create your first booking form

Open Dashboard in the Simpro booking forms section. Until the account has a form and a Simpro integration chosen in its booking settings, Dashboard shows Getting started with three steps: Connect to Simpro, Create a form and Next steps.

If a Simpro integration is already chosen, Getting started opens on Create a form.

Before you start

  • The address you log in to Simpro at, for example yourcompany.simprosuite.com.
  • For the Advanced method, a Simpro API key. The page lists how to make one beside the form.
  • A paid plan if the first form should create quotes. Quote is greyed out on the free plan, with the note "Quotes are only available with a paid plan."

Step by step

  1. Under Connect to Simpro, choose a Connection method: Simple ("Use your Simpro login to create an integration.") or Advanced ("Use a Simpro API key to create an integration.").
  2. For Simple, type your build name into Simpro Build URL, choose .simprosuite.com or .simprocloud.com, and click Log in to Simpro. Confirm the Confirm Simpro login prompt. Simpro's login page opens, and you come back to this page with the connection made.
  3. For Advanced, enter the full address in Simpro Build URL (for example https://yourcompany.simprosuite.com) and the key in Simpro API Token. Click Test connection, then Save credentials. Save stays unavailable until the test has run ("Test connection first").
  4. Under Create a form, fill in Form Name, Simpro Project type, Simpro Company and Default Timezone, then click Create form. The button stays greyed out until all four are set.
  5. Under Next steps, click Continue to editing your form, or View dashboard.

To make the API key in Simpro for the Advanced method: open Setup, System Setup, API, Applications, then Create Application. Set Company to Formpiece, Name to Formpiece integration and Authentication Method to API Key. Copy the key into Simpro API Token. You need to be logged in as a Simpro user who has access to the system settings.

Field What it does
Form Name At least 5 characters. You can change it later.
Simpro Project type Job or Quote. This is what is created in Simpro when a booking is made.
Simpro Company Where Formpiece reads Simpro data from and saves bookings to. The list loads from Simpro once the connection is made.
Default Timezone Starts as your browser's time zone. Used for time calculations.

The Next steps screen is a planning list: the services to offer and a pre-build for each, a technician calendar and working hours, the project, site and customer fields to collect, and a plan if you need more than the free one.

The dashboard once you are set up

  • Reports shows booking enquiries for Today, This Week, This Month or All Time, for all forms or one form. The numbers are enquiries received, jobs created, quotes created, callbacks, dates to organise and errors. Below them are a split of what happened to each enquiry (Booked with a date, Callback requested, Date to organise, Simpro error, Failed), a table by form, and the most common errors grouped by message. Auth link activity repeats this for auth links.
  • Forms shows total forms and active forms. An active form is one that has taken at least one booking.
  • Integrations shows Connected or Not connected for Simpro, Stripe and Square. A connection counts as connected when the integration chosen in the booking settings still exists on the account.
  • Services shows total services, which adds the service templates switched on for booking forms to any services saved directly on a form, and paid services, the ones that ask for a payment amount.
  • Plan shows the available plans, marks your current one with Current plan, and links to Manage subscription.

When it goes wrong

"Could not verify the Simpro credentials. Please check your details and try again."

The test could not reach Simpro with that build address and key. "Could not verify the Simpro credentials. Please try again." means Simpro answered but returned no companies.

"Could not save the Simpro integration. Please try again."

The credentials tested but could not be stored. Click Save credentials again.

"Could not connect to Simpro. Please try again."

The return from Simpro's login did not produce a token. If Simpro gave a reason, the page shows that instead.

The button says "Waiting for Simpro config"

The page shows "Simpro login is not available right now. Please refresh the page and try again." Reload the page.

The company list is empty or Create form stays greyed out

Simpro Company is loaded from Simpro after the connection is saved. Wait for the list to load, then pick a company. Name, project type, company and time zone all have to be set.

"Bookings could not load"

The dashboard could not read your forms and settings. Click the retry button on the message.