Subscribe to activity events using callbacks

The Activity service supports callback subscriptions, allowing external services to receive notifications when matching activity events occur.

This feature enables integrations such as audit pipelines, automation triggers, or external monitoring systems.

Before you begin:  

  • Authenticate your requests using one of the following methods:

    • An RBAC token in the X-Authentication header

    • A Puppet Enterprise SSL client certificate

  • Ensure your user or service account has the required RBAC permission: activity:manage_subscriptions:*

    This permission is included in the Administrators role by default (which also covers the api_user certificate principal used by PE services).

  • If your account does not have this permission (either through the Administrators role or a custom role), requests will fail with a 403 Forbidden error.

There is no update endpoint. To modify a subscription, delete and recreate it.