> ## Documentation Index
> Fetch the complete documentation index at: https://www.carstoragesoftware.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Shopmonkey

> Put Shopmonkey jobs and appointments on your storage calendar so the shop and the facility see the same work.

Shopmonkey is a shop system many facilities use for repair jobs. Connecting it puts those jobs on your [Schedule](https://www.carstoragesoftware.com/dashboard/schedule) next to storage appointments.

Booked Shopmonkey appointments become scheduled events. Work orders attach as job details. If a work order has no appointment, Car Storage Software still creates an event from the due date or created date.

This lives under [Settings > Integrations](https://www.carstoragesoftware.com/dashboard/settings/integrations), not Services & schedule.

## What you will accomplish

* Open **Shopmonkey** and paste the Shopmonkey API key.
* Click **Connect Shopmonkey** so new jobs can arrive on their own.
* Match Shopmonkey locations to your facilities, then import recent jobs.
* Open [Schedule](https://www.carstoragesoftware.com/dashboard/schedule) and confirm a known job is there.

## When to connect Shopmonkey

Use this when the shop already books work in Shopmonkey and the storage team needs the same jobs on the facility calendar.

Skip this if you do not use Shopmonkey.

## Before you start

* Your Shopmonkey plan includes API access.
* You need Schedule permission to open [Settings > Integrations](https://www.carstoragesoftware.com/dashboard/settings/integrations).
* In Shopmonkey, go to Settings → API and create a key. Copy it somewhere safe.
* Know which Shopmonkey location matches each of your facilities.

## Connect Shopmonkey

<Steps>
  <Step title="Open Integrations">
    Go to [Settings > Integrations](https://www.carstoragesoftware.com/dashboard/settings/integrations) and click **Shopmonkey**. You can also type **shopmonkey** in **Search integrations...**
  </Step>

  <Step title="Paste the API key">
    In the Shopmonkey window, find the **API key** box. Paste the key from Shopmonkey Settings → API.

    **Expected result:** The **Connect Shopmonkey** button becomes ready to click after the key is long enough.
  </Step>

  <Step title="Click Connect Shopmonkey">
    Click **Connect Shopmonkey**.

    **Why this matters:** Connecting tells Shopmonkey where to send live updates. New appointments and work orders can then appear on your calendar without a daily import.
  </Step>

  <Step title="Confirm the card">
    Close the window and check the Shopmonkey card.

    **Expected result:** The card shows **Connected**.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/carstoragesoftware/G8UHOQQoCr9klzqv/images/settings/integrations-shopmonkey-dialog-sep16.webp?fit=max&auto=format&n=G8UHOQQoCr9klzqv&q=85&s=62be391df09ce9aea6ccda008bd8b25a" alt="Shopmonkey integration window with API key box and Connect Shopmonkey button" width="1440" height="1400" data-path="images/settings/integrations-shopmonkey-dialog-sep16.webp" />
</Frame>

*Paste the Shopmonkey API key, then click Connect Shopmonkey. You do this from Settings → Integrations, not from the calendar.*

<Warning>
  **If you do not see the API key box**

  Refresh the page and open **Shopmonkey** again. You need Schedule permission. If the box is still missing, ask a team admin or Car Storage Software support to turn Shopmonkey on for the facility, then try again.
</Warning>

## Map locations and import recent jobs

After the connection works, the same window shows mapping options.

<Steps>
  <Step title="Match locations">
    Under **Locations**, pick the Car Storage Software facility that matches each Shopmonkey location.
  </Step>

  <Step title="Keep or change the default event type">
    **Default event type** is usually **Shopmonkey Job**. Change it only if your team already created a better matching event type.
  </Step>

  <Step title="Map statuses if you want">
    **Shopmonkey workflow → CSS status** controls how a Shopmonkey column appears on your calendar (for example **In progress**).

    **CSS status → Shopmonkey workflow** is optional. Fill it in only if a status change here should also move the Shopmonkey job.
  </Step>

  <Step title="Save mappings">
    Click **Save mappings**.
  </Step>

  <Step title="Import last 90 days">
    Click **Import last 90 days**, then open [Schedule](https://www.carstoragesoftware.com/dashboard/schedule) and look for a job you already know.

    **Expected result:** Recent appointments and work orders appear on the calendar. Opening a synced event shows the Shopmonkey work order number and status.
  </Step>
</Steps>

Customers and vehicles match an existing record first. If there is no match, the app uses VIN or email/phone. A license plate alone is never treated as unique.

## Optional two-way settings

Leave these off until you are sure you want them.

<Info>
  **Create walkthrough sessions for imported jobs** starts a walkthrough when a job arrives.

  **Allow CSS billing on imported jobs** lets your team bill from the imported event. It does not charge a card by itself.

  **Create matching Shopmonkey jobs for new CSS events** creates a Shopmonkey job when your team adds an event here. You can limit that to certain event types.
</Info>

<Note>
  **Imported jobs do not text customers by default**

  Inbound sync does not send texts or create card charges unless you turn those options on. That protects customers from surprise messages while you test the first import.
</Note>

## Confirm it worked

* The Shopmonkey card shows **Connected**.
* A known Shopmonkey job appears on [Schedule](https://www.carstoragesoftware.com/dashboard/schedule).
* A new Shopmonkey appointment appears later without another import.

## Troubleshooting

<Warning>
  **Connect Shopmonkey fails**

  Check that you copied the full key from Shopmonkey Settings → API. Try a new key if the old one was revoked. Live updates also need your facility’s public website address — a home computer address will not receive Shopmonkey updates.
</Warning>

<Tip>
  **The wrong facility got the job**

  Reopen Shopmonkey, fix **Locations**, click **Save mappings**, then import again or wait for the next live update.
</Tip>

<Note>
  **I cannot see QuickBooks or Xero**

  Accounting cards stay dimmed until payments are on. Shopmonkey stays available without payments. See [Connect HubSpot](/docs/settings/connect-hubspot) if you also want sales contacts to sync.
</Note>

## What to do next

Review the **Shopmonkey Job** event type on [Services & schedule](https://www.carstoragesoftware.com/dashboard/settings/events) if the calendar label should look different. For invoices in the books, see [Connect accounting integrations](/docs/settings/connect-accounting-integrations).


## Related topics

- [Connect HubSpot](/docs/settings/connect-hubspot.md)
- [Connect accounting integrations](/docs/settings/connect-accounting-integrations.md)
- [Browse the Integrations catalog](/docs/settings/browse-the-integrations-catalog.md)
- [Settings overview](/docs/settings/overview.md)
- [Connect the API](/docs/settings/connect-api.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.