The integration links your BoothBook account to your Pictor company so BoothBook can send booking information to Pictor. It is configured in both platforms: an API key goes from BoothBook into Pictor, and your Company ID goes from Pictor into BoothBook. You only do this once.

**Watch the setup in action**\
See how to connect BoothBook and Pictor using the BoothBook API key and your Pictor Company ID.

[Boothbook Integration.mp4](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSVhUL0FZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--f93eb236e8069d4b54ae497c327ba554449c9904/Boothbook%20Integration.mp4)

## **—Before you start**

**What you need:** An account on both sides, and permission to reach the settings pages below.

* Your **BoothBook** account, with access to **Settings** and its **Developers** section

* Your **Pictor** account, with access to **Integrations**

Two values change hands, in opposite directions. It helps to keep both tabs open.

| **Value**             | **Made in** | **Pasted into** |
| --------------------- | ----------- | --------------- |
| **BoothBook API key** | BoothBook   | Pictor          |
| **Pictor Company ID** | Pictor      | BoothBook       |

## **01 . Create an API key in BoothBook**

**What it does:** Lets Pictor connect securely to your BoothBook account.

1. Sign in to **BoothBook**.

2. Open **Settings**.

3. Scroll down to the **Developers** section and open it.

4. Find **API Keys**.

5. Select **Add API Key**.

6. Give it a name — *Pictor Integration* is a good one.

7. Create the key, then **copy it**.

![The BoothBook account menu open, with Settings at the bottom and an Apps entry under Explore.](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTHpnL0FZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--0b8f4476b2e6e5a3fc879b653945c6e75e008d11/bb-10-settings.jpg?cw_image_width=720px)

Open the account menu at the bottom left. **Settings** is at the foot of it.

![The BoothBook settings navigation scrolled to the bottom, showing an Advanced group with Developers in it.](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTWJnL0FZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--51ef2df705b7a5678e4ccc1f7e15cdedcc4eb9d2/bb-11-developers.jpg?cw_image_width=720px)

Inside Settings, scroll the left-hand list to the bottom. **Developers** sits under **Advanced**.

![The Developers API Keys page listing a key named Pictor with an Active status, and an Add API key button.](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTlBnL0FZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--815eefd4f3fef86d2e8ad49cc412098127f657fd/bb-12-apikeys.jpg?cw_image_width=720px)

Developers → API Keys. Press **Add API key**, name it, and copy the key it gives you. The key here is masked; yours is shown in full.

Your new key appears in the list as **Active**, with **Last Used** reading *Never* until Pictor first calls BoothBook. Copy it — you paste it into Pictor in step 3.

Treat it like a password

An API key gives whoever holds it access to your BoothBook account. Do not send it by email, chat or a support ticket, and mask it in any screenshot — the key above is blanked out for that reason. If one is exposed, open the **…** menu on its row, remove it, and create a replacement; then paste the new key into Pictor.

## **02 . Open the BoothBook integration in Pictor**

**What it does:** Finds the panel where both values live.

1. Sign in to **Pictor**.

2. Open **Integrations** from the side navigation.

3. Find **BoothBook** in the list and open it.

The panel holds both halves of the exchange: your **Company ID** at the top, and the **BoothBook API Key** field below it.

![The BoothBook section in Pictor Integrations, showing Your Company ID and the BoothBook API Key field.](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTjNnL0FZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--2f93350600f4acf3fc221503c0e4d09705dbffc2/bb-01-apikey.jpg?cw_image_width=720px)

Integrations → BoothBook. Company ID above, API key below.

## **03 . Add the BoothBook API key to Pictor**

**What it does:** Saves the key so Pictor can talk to BoothBook.

1. Paste the key into **BoothBook API Key**.

2. Save.

Once saved, Pictor shows only the last few characters — *A key is saved (****tclk). Enter a new one to replace it.* That is how you confirm a key is stored. To rotate, paste a new key over it; to remove it, press **Unlink BoothBook**.

Note

Saving the key is one direction only. BoothBook still does not know which Pictor company to talk to — that is steps 4 to 6.

## **04 . Copy your Pictor Company ID**

**What it does:** Identifies your Pictor company to BoothBook.

1. On the same BoothBook panel, find **Your Company ID**.

2. Press **Copy**.

![The Your Company ID field in Pictor with a Copy button beside it.](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCT3JnL0FZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--7630142858a8efbc5e29ea01503971943e14b4db/bb-02-companyid.jpg?cw_image_width=720px)

Your Company ID, with Copy. Keep it on the clipboard for the next step.

Note

The Company ID is not a secret — it already appears in your public [Lookbook link](https://support.pictor.pro/hc/pictorpro-support/articles/1791380301-lookbook). It identifies your company; it does not grant access to it.

## **05 . Open the Pictor app in BoothBook**

**What it does:** Finds where BoothBook stores your Company ID.

1. Return to **BoothBook**.

2. Go to **Apps** (also called the **App Centre**).

3. Search for **Pictor**.

4. Open the Pictor app and select **Configure**.

BoothBook asks for your Pictor Company ID.

![The BoothBook account menu with Apps highlighted under the Explore column.](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUFRnL0FZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--311509fe8c53a83eb7a146a8d8c252089dbc3722/bb-13-apps.jpg?cw_image_width=720px)

**Apps** sits under **Explore** in the account menu — the same menu you opened in step 1.

![The BoothBook App Centre with Pictor searched, showing the Pictor app marked Installed with Configure and View buttons.](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQXZoL0FZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--51f4ff38c4b955ae9e086de611e6d12372fde949/bb-14-appcentre.jpg?cw_image_width=720px)

Search the App Centre for Pictor, then press **Configure**. **View** only opens the listing.

Note

The app shows as **Installed** once it is on your account. Installed is not the same as configured — it still needs the Company ID in the next step before anything works.

## **06 . Add your Pictor Company ID**

**What it does:** Completes the link, in the other direction.

1. Paste the Company ID you copied in step 4 into **Company ID**.

2. Choose a **Client Portal Visibility**.

3. Press **Save**.

![The Pictor Settings dialog in BoothBook, with a Company ID field and a Client Portal Visibility dropdown.](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQlhoL0FZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--76aa16294e85b74916b977ac7c414f32b9e040c6/bb-15-configure.jpg?cw_image_width=720px)

Pictor Settings in BoothBook. The Company ID is the one from Pictor; visibility decides who gets the Pictor step.

### **Client Portal Visibility**

This decides which customers are offered the Pictor step in their portal. *Show for all customers* is the default and is what you want unless you have a reason to narrow it — a customer who is not shown the step never picks a design, so no event is prepared for their booking.

Both values are now in place:

* **BoothBook API key** → saved in Pictor

* **Pictor Company ID** → saved in BoothBook

Your BoothBook account and your Pictor company are connected.

**Next step**

See [How to Use Pictor with a BoothBook Booking](https://support.pictor.pro/hc/pictorpro-support/articles/1791386605-how-to-use-pictor-with-a-booth_book-booking) to create a booking, send the Client Portal, and get the event into Pictor.