# simPRO

Connect simPRO with an API key in about five minutes, so each booking becomes a simPRO service job that follows its moves and cancels.

Source: https://tapbook.au/docs/simpro. Updated 8 October 2026.

Each new booking becomes a job in simPRO, with its customer and site, so you never type it in twice. Create an API key in simPRO, paste it on Settings, and new bookings start going across.

## What it does

TapBook takes the bookings, from Google, your website and your phone, and simPRO keeps running your jobs. You don't change how you work in simPRO.

- Every booking, quote request, call-back and enquiry becomes a service job in simPRO, including ones the [phone assistant](https://tapbook.au/docs/phone-assistant) takes and ones your team adds.
- TapBook finds the customer in simPRO by email, then by mobile. If they aren't there, it adds them.
- The job goes at the address the form asked for, or the customer's first site, or a new site.
- When the booking moves or is cancelled in TapBook, the job follows.

## Before you start

You need:

- **An owner log-in to TapBook.** Only owners can connect simPRO.
- **An admin log-in to simPRO** that can open **System**, then **Setup**.
- **Your simPRO address.** It's the address you log in to simPRO at, like jaxplumbing.simprosuite.com.
- **The simPRO card on Settings.** If [Settings](https://tapbook.au/dashboard?go=settings/simpro) has no **simPRO** card, email [hello@tapbook.au](mailto:hello@tapbook.au) and we'll turn it on.

## Create an API key in simPRO

1. Log in to simPRO. On the home page, choose the cog in the top right, then **Setup**.
2. In the **System Setup** menu on the left, open **API**, then choose **Applications**.
3. The **Applications** page shows either **Create Application** or **Request API Access**. Follow the steps below for the one you see.

### If you see Create Application

1. Choose **Create Application**.
2. Name it TapBook.
3. Set **Authentication Method** to **API Key**, and save.
4. Download the key file. Open it and copy the **access_token**. Pasting the whole file works too: TapBook takes the access_token from it.

The key doesn't expire. It can add and change customers, sites and jobs in your simPRO company, whoever created it.

### If you see Request API Access

simPRO has to switch the API on for your account first.

1. Choose **Request API Access**.
2. For the request type, choose **Build something myself**.
3. For the description, enter TapBook.
4. Choose **Submit**.

simPRO emails you when it's done. If the email has an API key, paste that in TapBook. If it says the API is on, go back to **Applications** and follow [If you see Create Application](#if-you-see-create-application).

## Connect it in TapBook

1. Open [Settings](https://tapbook.au/dashboard?go=settings/simpro). The card is **simPRO**.
2. In **Your simPRO address**, enter the address you log in at, like jaxplumbing.simprosuite.com. With or without https:// is fine.
3. In **Your simPRO API key**, paste the access_token.
4. Choose **Connect**.

The toast says **simPRO connected. New bookings go there from now on.** The card now says **Connected to** your simPRO company, with a **Connected** chip, your address, and the last 4 characters of the key.

Bookings made before you connect stay in TapBook. Only new ones go to simPRO.

Can't do it yourself? Email the key file and your simPRO address to [hello@tapbook.au](mailto:hello@tapbook.au) and we'll connect it for you. Delete the email once it's connected.

## Check it worked

1. Make a test booking on your booking page.
2. Within a minute, it shows under **Sent to simPRO** on the card as **Sent**.
3. In simPRO, the customer, their site and a service job due at the booking's time are there.

Cancel the test booking in TapBook, and 10 seconds later the job is archived in simPRO.

## What changes in simPRO

| In TapBook | In simPRO |
|---|---|
| A booking with a time | A service job, pending, due at the booking's time |
| A quote request, call-back or enquiry | A service job with no due date |
| The booking moves, from the booking page or on the [calendar](https://tapbook.au/docs/calendar) | The job's due date and time move |
| A quote or call-back is booked in | The job is due at that time |
| The booking is cancelled | The job is archived, 10 seconds later |
| The cancel is undone | The job is back, pending, due at its time |
| Confirmed, quote sent, completed or no-show | Nothing changes |

A cancel waits 10 seconds so **Undo** on the booking can stop it before simPRO hears of it.

After the first send, TapBook only changes the job's due date and time, and only archives or restores it while its stage is still the one TapBook gave it. A job someone has started, completed or invoiced in simPRO stays as it is. Everything else about a job is yours to change in simPRO.

## The log

**Sent to simPRO**, on the card, lists every job TapBook sent, or tried to: **When**, **Booking**, **Change** and **Status**. **Booking** opens the booking. **Show more** loads older rows.

**Status** is one of:

- **Waiting** or **Sending**: on its way.
- **Sent**: it's in simPRO.
- **Trying again**: simPRO didn't answer, so TapBook tries again on its own.
- **Not sent**: TapBook gave up. **Retry** sends the booking as it is now.
- **Sent with a later change**: this change didn't go, but a later one for the same booking did, so the job is up to date.
- **Skipped**: TapBook left the job alone. The line under it says why, such as **The job was changed in simPRO, so TapBook left it.** or **simPRO was disconnected.**

## Replace the key or disconnect

**Replace key** opens **Replace simPRO's API key**. Paste the new access_token and choose **Replace key**. The toast says **API key replaced.** Use it when you've made a new key in simPRO.

**Disconnect** asks **Disconnect simPRO?** New bookings stop going to simPRO. The customers and jobs already there stay as they are. Then delete the TapBook application in simPRO too, under **System**, **Setup**, **API**, **Applications**.

## Troubleshooting

### Not a simPRO address

The card says **That isn't a simPRO address.** The address has to be the one you log in at, ending in simprosuite.com or simprocloud.com, like jaxplumbing.simprosuite.com.

### Key not accepted

The card says **simPRO didn't accept that key.** Check you copied all of the access_token, or paste the whole key file. If it still says so, make a new application in simPRO and paste its key.

### No answer at your address

The card says simPRO didn't answer at your address. Check the address is the one you log in at. If it is, try again in a minute.

### Needs connecting

The card shows a **Needs connecting** chip when simPRO stopped accepting the key, for example because the application was deleted in simPRO. The card says why and shows the key field again. Make a new key in simPRO and paste it. Bookings made or changed in the meantime go across when you do.

### Phone assistant bookings

They go to simPRO too. Every booking and request goes the same way, wherever it came from.

### More than one company

If your simPRO has more than one company, jobs go to the first company in your simPRO. If that's the wrong one, email [hello@tapbook.au](mailto:hello@tapbook.au).

### Using ServiceM8 instead

See [ServiceM8](https://tapbook.au/docs/servicem8).
