> For the complete documentation index, see [llms.txt](https://docs.introist.com/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.introist.com/knowledge-base/build/data-sources/severa.md).

# Severa

Connecting Severa to Introist only takes a few steps. First, you need to get an API credentials from your Severa account and then create a Data Source to Introist.

#### Create Severa API Credentials

To create Severa API Credentials, follow [these Severa instructions](https://api.severa.visma.com/rest-api-doc) until the heading "Environment URL".

Here's some guidance on what to submit to the fields:

<table><thead><tr><th width="237">Field</th><th>Value</th><th data-hidden></th></tr></thead><tbody><tr><td>Integration target system</td><td>Introist</td><td></td></tr><tr><td>Integration description</td><td>Sync users to Introist for automated workflows.</td><td></td></tr><tr><td>Contact Person</td><td>&#x3C;Most likely your name> </td><td></td></tr><tr><td>Select API scopes</td><td>users:read, hours:read, activities:read</td><td></td></tr><tr><td>I have an integration partner</td><td>yes</td><td></td></tr><tr><td>Integration partner details</td><td>Integration partner company: <strong>Introist</strong></td><td></td></tr><tr><td></td><td>Contact person name: <strong>Klaus Julin</strong></td><td></td></tr><tr><td></td><td>Contact person email: <strong>klaus.julin@introist.com</strong></td><td></td></tr></tbody></table>

When you have successfully created Client credentials, you are ready to connect Severa to Introist. You might want to copy your "Client ID" and "Client secret" to have them easily available in the next step.

\
**Create Data Source**

To add Severa as a Data Source to Introist, navigate to Data => Data sources. Click "Connect data source" and select "Severa" from the integration list. You can change the name for the Data source if you like. \
Copy and paste the Client ID and Client secret from your Severa REST API settings (see above). Finally, click "Connect" to save the configuration.

You have now successfully connected Severa to Introist!<br>

#### What next?

Next steps depends on your intended use case. Your Introist implementation expert will guide you on selecting what employee data to sync from Severa.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.introist.com/knowledge-base/build/data-sources/severa.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
