# Sigma

## Identify your organization's cloud <a href="#h_01hwzer5pmndd1genk5jm935yb" id="h_01hwzer5pmndd1genk5jm935yb"></a>

You'll need your organization's cloud details to identify the endpoint for Paradime authentication.

{% hint style="info" %}
For GCP organizations, use: `https://api.sigmacomputing.com/`

For AWS organizations, use: `https://aws-api.sigmacomputing.com/`
{% endhint %}

To identify your organization's cloud:

1. Login to your Sigma account.
2. In the top right of the screen, click your **profile avatar** and then click **Administration** to open your *Account* page.
3. On the *Account* page, under *Site* in *General Settings*, view the cloud details.

<figure><img src="https://2337193041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHET0AD04uHMgdeLAjptq%2Fuploads%2FDFf5oyaHFiYphFeZ38qz%2FScreenshot%202024-07-03%20at%2012.58.29.png?alt=media&#x26;token=28160b97-7eec-498b-9982-80d11b01487c" alt=""><figcaption></figcaption></figure>

## Create an API token and client ID

To create an API token and client ID:

1. Login to your Sigma account.
2. In the top right of the screen, click your profile avatar and then click **Administration**.
3. In the left panel, navigate to **Developer Access**.
4. In the top right of the *Developer Access* page, click the **Create New** button.
5. In the *Create client credentials* dialog,&#x20;
   1. *Select privileges:* click the **Rest API** checkbox
   2. *Name:* enter a meaningful name like `Paradime API credentials`
   3. *Owner:* select the user you would like to associate with the token
6. Click **Create** to finish creating the API token.
7. Once prompted, copy and paste your Client ID and API key secret in a secure location.

Both the API token and the client ID are required for authentication in Paradime.

### Verify necessary permissions <a href="#h_01hwzer5pm8mt1yxvyh2fe8ahs" id="h_01hwzer5pm8mt1yxvyh2fe8ahs"></a>

{% hint style="info" %}
Ensure that the owner associated with the API token has the following permissions:

* `Can View` permission for all the Sigma workbooks and datasets you want to crawl.
* `Can Use` permission for all the Sigma connections used in the workbooks and datasets.
  {% endhint %}

To grant permissions, follow the instructions in these links:

* [Workbooks and datasets](https://help.sigmacomputing.com/hc/en-us/articles/4402444938003)
* [Connections](https://help.sigmacomputing.com/hc/en-us/articles/360037430393)

## Connect the Sigma integration <a href="#enabling-the-integration" id="enabling-the-integration"></a>

The Sigma integration is set up by the **Admin user** for your organization profile. To enable the integration open your *Account Settings > Integrations* find the Sigma integration and click Connect.

1. Add your Host Name, Client ID and Client Secret to get Paradime connected to your Sigma instance.
2. Click on Test Connection to validate that Paradime can connect to your Sigma account.

{% @arcade/embed flowId="9CR0Aem8szribXMiVEDc" url="<https://app.arcade.software/share/9CR0Aem8szribXMiVEDc>" %}

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.paradime.io/app-help/documentation/integrations/dashboards/sigma.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.