Configure in Kajoo

Once the Kajoo plugin is installed in your Sitecore environment, the next step is to connect your JSS project repository with Kajoo. This allows Kajoo to read components, generate page layouts, and publish updates directly into your Sitecore instance.

This guide applies to all Sitecore setups (On-Prem, PaaS, Containers, XM Cloud).


Prerequisites

Before continuing, make sure:

  • The Kajoo plugin is installed and verified in your Sitecore environment
  • You have access to a GitHub or Azure DevOps repository containing your JSS app
  • The JSS app follows the structure and guidelines from the Preparing Your JSS App

1. Create an API Key in Sitecore

In your Sitecore instance (where the Kajoo plugin is installed):

  • In the Sitecore Content Editor, navigate to: /sitecore/system/Settings/Services/API Keys
  • Right-click the API Keys item and select Insert → API Key
  • Enter a name for your API key (e.g., Kajoo Integration Key)
  • In the CORS Origins field, enter https://app.kajoo.ai or *
  • In the Allowed Controllers field, enter *
  • Save and publish the item
  • Copy the Item ID of the API key item — this is the value you will use as your API key

2. Create a Sitecore Integration in Kajoo

Go to Integrations tab after clicking on Sitecore XM/XP and click on Add Integration:

  • Give your integration a friendly name (e.g., Marketing Sitecore Dev, Staging CMS)

  • Enter the Sitecore URL where the Kajoo plugin is installed

  • Paste the API Key Item ID you created in Sitecore

  • Click Test Connection to verify access

  • Click Add Integration to finalize the integration and the integration will appear in the Sitecore XM/XP drawer. You can edit and delete the integration from the listing.

⚠️ Make sure the API Key item is published, and that the CORS Origins field is set to https://app.kajoo.ai or * to allow requests from Kajoo.

Once the integration is ready, you can now Create Site from the Sites section.


3. If Sitecore Is Behind VPN or Firewall

Kajoo needs access to the Sitecore CM instance. If your environment is secured, refer to the Integrate with a Secured Sitecore Environment Guide to configure a secure connection.