infisical/docs/documentation/platform/event-subscriptions.mdx

---
title: "Event Subscriptions"
sidebarTitle: "Events"
description: "Subscribe to events in Infisical for real-time updates"
---

<Info>
  **Note:** Event Subscriptions is a paid feature. - **Infisical Cloud users:** Event Subscriptions is
  available under the **Enterprise Tier**. - **Self-Hosted Infisical:** Please
  contact [[email protected]](mailto:[email protected]) to purchase an
  enterprise license.
</Info>


Event Subscriptions in Infisical allow you to receive real-time notifications when specific actions occur within your account or organization. These notifications can include changes to secrets, users, teams, and other important resources.

You can currently subscribe to notifications for the following event types:

### Supported Event Types

- `secret:created`: Triggered when a secret is created.
- `secret:updated`: Triggered when a secret is updated.
- `secret:deleted`: Triggered when a secret is deleted.


## Permissions Setup

In order to receive events on a supported resource, the identity is required to have a Subscribe permission on that resource. Follow these steps to set up the necessary permissions:

<Steps>
  <Step title="Select a project and copy the 'Project ID'">
    ![Select Project](/images/platform/events/select-project.png)
    On your project page, open <strong>Project Settings</strong> from the sidebar.<br />
    In the Project name section, click <strong>Copy Project ID</strong> to copy your Project ID, or extract it from the URL:<br />
    `https://app.infisical.com/project/<your_project_id>/settings`
  </Step>

<Step title="Navigate to 'Access Management' and open 'Project Roles'">
  ![Project Detail](/images/platform/events/project-detail.png) ![Project
  Access](/images/platform/events/project-access.png) Navigate to{" "}
  <strong>Access Management</strong>, then select <strong>Project Roles</strong>
  .
</Step>

<Step title="Select an existing role or create a new one">
  ![Project Role](/images/platform/events/project-role.png) You can either edit
  an existing role or create a new role for event subscriptions.
</Step>

<Step title="Assign policies to the role">
  ![Role Detail](/images/platform/events/role-detail.png) Select the specific
  resources that the role should have access to.
  <br />
  ![Add policy](/images/platform/events/add-policy.png)
</Step>

  <Step title="Enable the 'Subscribe' action in permissions">
    ![Policy setting](/images/platform/events/policy-setting.png)
    Ensure the <strong>Subscribe</strong> action is selected for the relevant resources and events.<br />
    <AccordionGroup>
      <Accordion title="Add conditions to your permissions">
        By default, the role will have access to all events for the selected resources in this project.
        If needed, you can add filters to limit the scope of accessible events.<br />
        ![Policy setting](/images/platform/events/add-conditions.png)
      </Accordion>
    </AccordionGroup>
  </Step>
</Steps>

## Usage

For integration and implementation details, please refer to our [API Reference](/api-reference/endpoints/events).

---

**Note:** Only users or roles with appropriate permissions can manage or subscribe to events.<br />

<strong>Availability:</strong> Event Subscriptions are not available on the Free
plan.