> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://cammio.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# View Integration Settings and Manage Webhooks

The **Integrations** page shows how your account is connected to your ATS or HRIS. It is also where you manage webhooks: messages Cammio sends to your own systems when something happens in your interviews.

|| Only **Admins** can see the Account settings, including the **Integrations** page.

---

## How to Open the Integrations Page

1. Hover over the **Settings** gear icon at the bottom of your left-hand sidebar.
2. Click **Account settings**. The **General** page opens directly.
3. Click **Integrations** in the **ACCOUNT** group on the left.

If you are already in your settings, you only need step 3.

---

## The Integrations Page

The page has two sections, **Connection settings** and **Webhooks**.

![](https://storage.crisp.chat/users/helpdesk/website/-/2/d/8/c/2d8ceb79554a0200/image_13mipia.png =516xauto)
---

## Connection Settings

If your account is connected to an ATS or HRIS, the page shows a **Connection settings** block with details of that connection. Accounts without a connection only see **Webhooks**.

The block is read-only. Cammio manages these settings, so to change any of them, contact your Client Success Manager.

| Row | What it shows |
| ---- | ---- |
| **Support emails** | Where Cammio sends integration error notifications. |
| **Invitations sent by** | Which system sends interview invitation emails to candidates, for example **Cammio**. |

---

## Webhooks

A webhook lets your own systems know when something happens in Cammio: when one of the events you chose occurs, Cammio sends an HTTPS POST message to your endpoint.

* You can have up to 3 webhooks. The counter above the list, for example **2 of 3 webhooks**, shows how many you use. To add another one when you've reached the limit, delete one first.
* Each webhook appears as a card. The card shows the endpoint URL, when the webhook was last updated and by whom, and the events it is subscribed to, grouped by category. The **⋯** button on the card opens a menu with **Edit** and **Delete**.

|| Webhooks have no name and no on/off switch. To pause a webhook, delete it. You can create it again later.

---

## Create a Webhook

1. Click **Add webhook** at the top right of the **Webhooks** section. The **Add webhook** window opens.
2. In **Endpoint URL**, enter the web address that should receive the messages. Only HTTPS endpoints are allowed, and Cammio sends a POST message to it.
3. Decide whether you want an email when the webhook fails. **Send webhook failure notification** is on by default. Enter one or more email addresses, separated by commas, in **Email addresses**. Turn the switch off if you don't want these alerts.
4. Under **Events**, tick the events you want Cammio to send to your endpoint.
5. Click **Save webhook**. The new webhook appears in the list.

![Create webhook](https://storage.crisp.chat/users/helpdesk/website/-/2/d/8/c/2d8ceb79554a0200/integrations-webhook-create-mo_1459teb.png =484xauto)

To close the window without saving, click the **×** at its top right.

##### Failure Notifications

Cammio sends one alert per failing endpoint per 24 hours, even if retries also fail. An endpoint counts as failing when it returns an HTTP 500+ error or doesn't respond.

##### Events

The events are grouped by category, such as **Invitations**, **Interviews** and **Transcriptions**. Each event has a short description, for example **When a candidate is invited**, with the technical name of the event next to it in gray.

---

## Edit a Webhook

1. Click the **⋯** button on the webhook's card and select **Edit**. The **Edit webhook** window opens with the webhook's settings filled in.
2. Change what you need: the **Endpoint URL**, the failure notification settings or the events under **Events**.
3. Click **Save webhook**.

To close the window without saving, click the **×** at its top right.

##### The Secret

Cammio generates a secret for each webhook when you save it. The **Secret** field in the **Edit webhook** window shows it. The field is read-only, and the copy icon at its right copies the secret. Cammio uses it to generate the **Cammio-Signature** header. Treat the secret like a password and share it only with the people who set up your endpoint.

![Rotate secret](https://storage.crisp.chat/users/helpdesk/website/-/2/d/8/c/2d8ceb79554a0200/integrations-webhook-edit-moda_1cl5c89.png =468xauto)

##### Rotate the Secret

Click **Rotate secret** under the **Secret** field to generate a new secret. The old secret stops working immediately, so update the system behind your endpoint with the new secret right away.

---

## Test a Webhook

To check that your endpoint receives messages, click **Test webhook** in the **Edit webhook** window. Cammio sends a sample event to your endpoint, marked as a test, and shows you the HTTP status and the response it got back.

The **Test webhook** button is only in the **Edit webhook** window, so save a new webhook first, then open it with **Edit**.

---

## Delete a Webhook

||| Deleting a webhook can't be undone. Events stop being sent to its endpoint.

1. Click the **⋯** button on the webhook's card and select **Delete**.
2. A window asks **Delete this webhook?** It tells you that events will stop being sent to the webhook's endpoint URL and that this can't be undone. Click **Delete webhook** to confirm, or **Cancel** to keep the webhook.

You can also delete a webhook with the red **Delete** button at the bottom left of the **Edit webhook** window.

---

## Next Steps
* Want to see the rest of your account details, including your integration if you have one? Read [View Your Account Details (General)](https://cammio.crisp.help/en/article/view-your-account-details-general-1wjp2l3/).
* Want an overview of all settings pages? Read [An Overview of Personal and Account Settings](https://cammio.crisp.help/en/article/an-overview-of-personal-and-account-settings-xp2zj6/).