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

# Creating a Sigma Connection

> Set up and configure a connection to your Sigma analytics platform

You can follow this guide to connect to your Sigma instance to Curator.

## Preparing Sigma

1. Obtain your Sigma API URL. To determine which URL to use, see Sigma's
   [documentation](https://help.sigmacomputing.com/reference/get-started-sigma-api#identify-your-api-request-url).
2. Generate embed client credentials (Client ID and Client Secret) in your Sigma instance. See Sigma's
   [documentation](https://help.sigmacomputing.com/docs/generate-embed-client-credentials) for detailed instructions.

## Connect to Curator

1. Go to the backend of your Curator instance. Navigate to **Integrations** > **Connections** using the
   left-hand menu.
2. Click the **New Connection** button at the top of the page.
3. Enter a name for the connection (something like "Sigma" is sufficient) and edit the slug if you'd like (but
   you don't need to).
4. Choose "Sigma" in the Platform dropdown. If the option is disabled then you already have a Sigma Connection created.
5. Fill out the form that appears below the Platform dropdown:
   * **Sigma API URL**: Select your Sigma API URL from the dropdown, or choose "Manual Entry" to enter a
     custom URL.
   * **Custom Sigma API URL**: If you selected "Manual Entry" above, enter your custom Sigma API URL here.
   * **Sigma Client ID**: The client ID generated from your Sigma embed client credentials.
   * **Sigma Client Secret**: The client secret generated from your Sigma embed client credentials.
6. Hit **Save** at the top of the page.

## Validate Connection

After saving, the connection form will show an authentication check section that verifies your credentials are
working properly with the Sigma API.

## Troubleshooting

### Sigma Does Not Appear in the Backend Navigation

After saving a Sigma connection, the **Sigma** section may not appear in the backend navigation for some users.
This is a permissions issue, not a connection issue — the connection itself is valid, but the backend user has
not been granted access to the Sigma plugin.

When a connection is saved, Curator automatically grants permissions to the user who saved it. Other backend
users must be granted access manually:

1. Log in as a super-administrator.
2. Navigate to **Settings** > **Administrators**.
3. Open the affected user's record and click the **Permissions** tab.
4. Under the **Sigma** section, enable **Sigma administrator**.
5. Save the user record.

The Sigma navigation items will appear for that user on their next page load.

### Workbooks List Is Empty

If the Sigma connection validates successfully but no workbooks appear when creating Sigma content in Curator,
the embed client credentials (Client ID and Client Secret) may not have access to those workbooks within Sigma.

The Sigma API authenticates successfully with valid credentials but only returns workbooks the embed client can
access. To resolve this, ensure the embed client credentials used in the connection have been granted access to
the relevant workbooks or folders inside your Sigma instance. Refer to Sigma's
[documentation on embed client credentials](https://help.sigmacomputing.com/docs/generate-embed-client-credentials)
for details on managing permissions.

## Next Steps

Once your Sigma connection is validated, the **Sigma Workbook** page builder element will still appear grayed
out until at least one Sigma Workbook record exists in Curator. To make the element selectable:

1. Navigate to **Content** > **Sigma Workbooks** in the backend menu.
2. Create one or more Sigma Workbook records pointing at the workbooks you want to embed.
3. Once at least one workbook exists, you can add the **Sigma Workbook** element to any page via the page
   builder and select the workbook to embed.