# Finding service connector credentials for Sitoo

## Required credentials

To [add a Patchworks connector](/product-documentation/patchworks-services/service-connectors/adding-a-service-connector.md) for **Sitoo**, the following details are required for authentication:

<table><thead><tr><th>Credential</th><th data-type="checkbox">Required</th><th>Note</th></tr></thead><tbody><tr><td><a href="#api-url">API URL</a></td><td>true</td><td>The default is <strong>api.mysitoo.com</strong> but this may vary per instance.</td></tr><tr><td><a href="#api-id">API ID</a></td><td>true</td><td>Obtained from the <strong>Base URL</strong> section of the generated API login page.</td></tr><tr><td><a href="#api-password">API Password</a></td><td>true</td><td>Obtained from the <strong>Base URL</strong> section of the generated API login page.</td></tr><tr><td><a href="#version">Version</a></td><td>true</td><td>Obtained from the <strong>Base URL</strong> section of the generated API login page.</td></tr><tr><td><a href="#account-id">Account ID</a></td><td>true</td><td>Obtained from the <strong>Base URL</strong> section of the generated API login page, or from the <strong>API ID</strong>.</td></tr><tr><td><a href="#site-id">Site ID</a></td><td>true</td><td>Obtained from the <strong>Base URL</strong> section of the generated API login page.</td></tr></tbody></table>

## Obtaining credentials

To obtain the required details, log into the Sitoo back office console and navigate to **settings** > **REST API**:

![](/files/exJQCISApccTmjk8zNJN)

From here, you can obtain the required credentials.

### API URL

The **API URL** for your Sitoo instance is displayed within the **Base URL** section of the generated API login page, together with the [API ID](#api-id) and [API Password](#api-password):&#x20;

<figure><img src="/files/aT8hh7h7DrTj0ukYvn1q" alt=""><figcaption></figcaption></figure>

The **API URL** must end with **mysitoo.com** - anything after that should be removed:

<figure><img src="/files/yKKidW70JJCrXDy0xcSU" alt=""><figcaption></figcaption></figure>

In our example, the **API URL** is:&#x20;

```
https://api-sandbox.mysitoo.com
```

### API ID

The **API ID** for your **Sitoo** instance is displayed within the generated API login page, together with the [API URL](#api-url) and [API Password](#api-password).<br>

### API Password

The **API Password** for your Sitoo instance is displayed within the generated API login page, together with the [API ID](#api-id) and [API URL](#api-url).

### Version

The API version is displayed within the [Base URL](#api-url) - it's the first section immediately after '.com' - for example:

<figure><img src="/files/6xQJiYqWqay8irLVYXP5" alt=""><figcaption></figcaption></figure>

In our example, the **version** is **v2**.

### Account ID

The **Account ID** is displayed as the last section of the [Base URL](#api-url) - for example:

<figure><img src="/files/3HrMPownQt7d9c6zvyjE" alt=""><figcaption></figcaption></figure>

It's also the first section of the  [API ID](#api-id). &#x20;

### Site ID

The **Site ID** should be the default of 1. However, the site ID can be changed to any respective site's ID.


---

# 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://doc.wearepatchworks.com/product-documentation/patchworks-services/service-systems/supported-service-systems/sitoo-service-connector/finding-service-connector-credentials-for-sitoo.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.
