From ad0652b5c10fafc2b0389337c2a4f1ea4aaa0af8 Mon Sep 17 00:00:00 2001 From: Paige Calvert Date: Mon, 30 Mar 2026 15:39:12 -0600 Subject: [PATCH 1/3] Edit per license event filter details --- .../reference/notifications-events-filters.md | 115 +++++++++++++----- docs/vendor/event-notifications-create.mdx | 6 +- 2 files changed, 84 insertions(+), 37 deletions(-) diff --git a/docs/reference/notifications-events-filters.md b/docs/reference/notifications-events-filters.md index 6cf30e2aa1..66104640fd 100644 --- a/docs/reference/notifications-events-filters.md +++ b/docs/reference/notifications-events-filters.md @@ -46,22 +46,47 @@ When a vendor sends an Enterprise Portal invite to a user ### Enterprise Portal Access Granted -When a user accesses the Enterprise Portal for a customer team. +When a user accesses the Enterprise Portal. The following table describes the available filters for the Enterprise Portal Access Granted event type: -| Filter | Required | Options | -|--------|----------|---------| -| Application | No | Any application in your account | -| Customer | No | Any customer for the selected application | -| Access Method | No | Invite, Self-Signup, SAML JIT | -| License Type | No | Paid, Trial, Community, Development | -| Access Type | No | Any Access, First Access for Selected License Type | - -The **Access Type** filter controls whether the notification fires on every access or only on first-access milestones per license type: - -- **First Access for Selected License Type**: The notification fires the first time a user accesses the Enterprise Portal for a customer with a specific license type. Use this with the **License Type** filter to track access milestones per license type. For example, combining this with License Type "Paid" fires when a customer first accesses the portal on a paid license, even if they previously accessed it on a trial. -- **Any Access** (default): The notification fires on every access event. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FilterRequiredOptions
ApplicationNoAny application in your account
CustomerNoAny customer for the selected application
Access MethodNoInvite, Self-Signup, SAML JIT
License TypeNoPaid, Trial, Community, Development
Access TypeNo +
    +
  • Any Access (default): Triggers a notification every time a user accesses the Enterprise Portal.
    • +
  • First Access for Selected License Type: Triggers a notification the first time that a customer with a specific license type accesses the Enterprise Portal. For example, if you select "Paid" for the License Type filter, then you will receive a notification the first time that a customer with a Paid license access the Enterprise Portal, even if they previously logged in when they had a Trial license.
    • +
+
### Enterprise Portal User Joined @@ -175,28 +200,54 @@ When a release is demoted from a channel. ### Release Assets Downloaded {#release-assets-downloaded} -When a customer pulls a release asset (Helm chart, Embedded Cluster bundle, or proxy registry image). This event fires one time per individual asset pull. It also includes whether this is the customer's first software pull. +When a customer pulls a release asset (Helm chart, Embedded Cluster bundle, or proxy registry image). Each individual asset pull triggers one Release Assets Downloaded event. The following table describes the available filters for the Release Assets Downloaded event type: -| Filter | Required | Options | -|--------|----------|---------| -| Application | No | Any application in your account | -| Channel | No | Any channel for the selected application | -| Customer | No | Any customer for the selected application | -| License Type | No | Paid, Trial, Community, Development | -| Asset Type | No | Helm Chart, Embedded Cluster Bundle, Proxy Registry Image | -| Pull Type | No | First Pull Only, First Pull for Selected License Type, Any Pull | - -The **Pull Type** filter controls whether the notification fires on every pull or only on first-pull milestones: - -- **First Pull Only**: The notification fires only when a customer pulls a release asset for the very first time, regardless of license type. If a customer first pulls on a trial license, this will not fire again when they convert to a paid license. -- **First Pull for Selected License Type**: The notification fires the first time a customer pulls a release asset with a specific license type. Use this with the **License Type** filter to track milestones per license type. For example, combining this with License Type "Paid" fires the first time a customer pulls on a paid license, even if they previously pulled on a trial. -- **Any Pull** (default): The notification fires on every pull. This is equivalent to leaving the filter unset, and all existing subscriptions behave this way. - -:::note -First pull tracking is forward-only. Customers who pulled software before March 18, 2026 will have `is_first_customer_pull: false` on all subsequent pulls. Per-license-type milestones only track pulls that occur after March 27, 2026. -::: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FilterRequiredOptions
ApplicationNoAny application
ChannelNoAny channel for the selected application
CustomerNoAny customer for the selected application
License TypeNoPaid, Trial, Community, Development
Asset TypeNoHelm Chart, Embedded Cluster Bundle, Proxy Registry Image
Pull TypeNo +
    +
  • Any Pull (default): Triggers a notification on every asset pull.
    • +
  • First Pull Only: Triggers a notification only the first time that a customer pulls a release asset.
    • +
  • First Pull for Selected License Type: Triggers a notification the first time that a customer pulls a release asset with the selected license type. For example, if you select "Paid" for the License Type filter, you will receive a notification the first time that a customer pulls a release asset using a Paid license, even if the customer had previously pulled assets using a Trial license.
    • +
+

For customers who pulled software before March 18, 2026, the Vendor Portal applies is_first_customer_pull: false on all subsequent pulls. **First Pull for Selected License Type** only tracks asset pulls that occur after March 27, 2026.

+
## Support events diff --git a/docs/vendor/event-notifications-create.mdx b/docs/vendor/event-notifications-create.mdx index 43e3a53c54..386768f4cb 100644 --- a/docs/vendor/event-notifications-create.mdx +++ b/docs/vendor/event-notifications-create.mdx @@ -123,7 +123,7 @@ As a Development Leader, I want to be notified when a paid customer pulls releas ### Revenue operations: First software pull for revenue recognition -As a Revenue Operations Manager, receive a notification the first time a paid customer retrieves software to record the exact revenue recognition timestamp. +As a Revenue Operations Manager, I want to receive a notification the first time a paid customer pulls software so that I can record the exact revenue recognition timestamp. - **Event Type:** Release Asset Downloaded - **Configuration:** @@ -132,10 +132,6 @@ As a Revenue Operations Manager, receive a notification the first time a paid cu - Filter - Pull Type: "First Pull for Selected License Type" - **Delivery Method:** Webhook to your customer relationship management system -:::note -Use "First Pull for Selected License Type" rather than "First Pull Only" if customers may start on a trial before converting to a paid license. "First Pull Only" tracks the first-ever pull regardless of license type. If a customer pulls on a trial license first, the notification will not fire again after they convert to paid. "First Pull for Selected License Type" tracks milestones per license type. The notification fires the first time the customer pulls software with a paid license, even if they previously pulled on a trial. -::: - ### Support engineer: Unhealthy instance alert As a Support Engineer, you want to be notified when a customer instance has been in an unhealthy state for an extended period so that you can proactively reach out. From f88eacfd83fe3d704f0703df3ddfff51c9c40253 Mon Sep 17 00:00:00 2001 From: Paige Calvert Date: Mon, 30 Mar 2026 16:00:07 -0600 Subject: [PATCH 2/3] add forward-only note --- docs/reference/notifications-events-filters.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/reference/notifications-events-filters.md b/docs/reference/notifications-events-filters.md index 66104640fd..e18a762f18 100644 --- a/docs/reference/notifications-events-filters.md +++ b/docs/reference/notifications-events-filters.md @@ -83,7 +83,8 @@ The following table describes the available filters for the Enterprise Portal Ac + +

First Access for Selected License Type only tracks Enterprise Portal access events that occur after March 27, 2026.

From 72df87ddbc774ad167a1f19ebe3e36c66d20ae87 Mon Sep 17 00:00:00 2001 From: Paige Calvert Date: Mon, 30 Mar 2026 16:37:35 -0600 Subject: [PATCH 3/3] small copyedit --- docs/reference/notifications-events-filters.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/notifications-events-filters.md b/docs/reference/notifications-events-filters.md index e18a762f18..0466b124d6 100644 --- a/docs/reference/notifications-events-filters.md +++ b/docs/reference/notifications-events-filters.md @@ -245,7 +245,7 @@ The following table describes the available filters for the Release Assets Downl
  • First Pull Only: Triggers a notification only the first time that a customer pulls a release asset.
  • First Pull for Selected License Type: Triggers a notification the first time that a customer pulls a release asset with the selected license type. For example, if you select "Paid" for the License Type filter, you will receive a notification the first time that a customer pulls a release asset using a Paid license, even if the customer had previously pulled assets using a Trial license.
    • -

    For customers who pulled software before March 18, 2026, the Vendor Portal applies is_first_customer_pull: false on all subsequent pulls. **First Pull for Selected License Type** only tracks asset pulls that occur after March 27, 2026.

    +

    For customers who pulled software before March 18, 2026, the Vendor Portal applies is_first_customer_pull: false on all subsequent pulls. Also, First Pull for Selected License Type only tracks asset pulls that occur after March 27, 2026.