# Jama

### Connect Jama in Violet

{% hint style="info" %}
The below instructions are for connecting cloud-based Jama. If your instance is self-hosted, skip this section and head [here](https://docs.violetlabs.com/apps/j/jama/connect-self-hosted-jama).
{% endhint %}

1. In [Violet](https://app.violetlabs.com/) (or [VioletGov](https://app.violetgov.com/)), navigate to **Integrations** and click  <img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FtlFf29W81Xw97AUJ5zwb%2FScreenshot%202026-02-19%20at%201.13.34%E2%80%AFPM.png?alt=media&#x26;token=c80f613a-d379-4cd4-a5c8-9c04e63e37ea" alt="" data-size="line"> to add a new integration.&#x20;
2. Select <img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FV8d3qH73ZBs2lJR6m8rK%2Fjama.png?alt=media&#x26;token=809b2ea3-0450-493e-984f-2f7dc839f1c3" alt="" data-size="line"> **Jama**

\[Optional] You can also provide a unique name for the connection based on the credentials you're using, and you can create **restricted permissions** to users or groups:

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FLNq8XfPFudyBudwAhJwe%2Fpermissions.png?alt=media&#x26;token=502752e3-2f38-4c8b-8fa0-2ff8b3a5a19a" alt="" width="375"><figcaption></figcaption></figure>

3. Provide the URL for your Jama instance:

![](https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FWAb1rk4C3GX5A4a77GJA%2FScreenshot%202024-06-03%20at%2012.58.36%E2%80%AFPM%20\(1\).png?alt=media\&token=0d4e7ec2-a81d-489f-a8c7-a6601a320afe)

4. For Basic Authentication, enter your Jama Username and Password and click **Connect.** \
   (Or head [here](https://docs.violetlabs.com/apps/j/jama/optional-connect-with-jama-client-id-and-secret) if you prefer to to connect with a Jama Client ID & Secret).

![](https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FnWBPJOB5Kd1UPkUT9lRe%2FScreenshot%202024-06-03%20at%202.17.57%E2%80%AFPM%20\(1\).png?alt=media\&token=8a7f3dd6-b8e2-40b4-bd8d-3919bba3e5a1)

5. Once connected, configure your integration (optional), then click **Create.** You're done!
   1. Select one or more Jama Projects to include in the integration scope. We recommend limiting one Jama Project to one Integration, so that imported projects will be rendered as Violet Programs, and contained requirements can be viewed in Violet Requirements Module (enabling commenting, peer reviews, shared program access, etc.)