# Precoro

## **Connect Precoro in Violet**

To connect Precoro in Violet, you will need to generate an API token. Open the [API Access Keys](https://app.precoro.com/manage/user/apitokens) page and click **Generate API Key.** Copy the key and continue on to the instructions below.

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%2FUwwXxGCERbaeAjbCGFZG%2Fprecoro.png?alt=media&#x26;token=c10d6cb8-6789-4aae-bdf1-ae6d4ef0ca4f" alt="" data-size="line">**Precoro**

\[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 your API Key and click **Connect**.
4. Once connected, configure your integration (optional), then click **Create.** You're done!

## Creating a Webhook for Violet in Precoro

Optionally, you can configure a webhook in Precoro that will allow Violet to fetch data on an event-driven basis. This also helps minimize the impact of API limits that Precoro places on the number of requests that it will process.&#x20;

The webhook will notify Violet when something in Precoro has been created or updated, allowing Violet to fetch that new information in \[near] real-time.

To add a webhook, follow the instructions below:

1. Navigate to [app.precoro.us](https://app.precoro.us/manage/webhook_notification_configurations)​
2. Click **New Webhook**
3. In the **Endpoint of your webhook** field, enter `https://`**`<your_violet_domain>`**`/api/violet-entity-fetch/webhook?applicationId=b0a5e080-662a-47b5-a1a2-3466a1d02317`, with your Violet URL as  **\<your\_violet\_domain>**. \
   \
   For example, if your Violet domain is **acme.violetlabs.com**, you should enter `https://acme.violetlabs.com/api/violet-entity-fetch/webhook?applicationId=b0a5e080-662a-47b5-a1a2-3466a1d02317`.
4. Under **Select what events to track with webhook**, select the `Create` and `Update` checkboxes for ***Purchase Order***, ***Purchase Requisition***, and ***Invoice***.
5. Click **Save**.
6. Last, ensure the webhook is switched to `Activated`.
