Skip to content

Event subscription

Integrations may subscribe to certain events coming from Accedo One, as listed in the Protobuf bundle in external/notification/events.proto. When part of the IntegrationService.GetManifest response, under manifest.eventSubscriptions, Accedo One will send a gRPC call to the integration's EventNotificationService.OnEvent with the event details in the request whenever such a notification should be issued.

There currently isn't any IDK UI that may be used to trigger such a notification to test your integration. In order to test single events, you may use grpcurl and the sample inputs below:

grpcurl -d @ -plaintext -import-path /tmp/protos -proto /tmp/protos/external/notification/notification.proto localhost:<your-integration-grpc-port> external.notification.EventNotificationService.OnEvent < /tmp/body.json

The /tmp/input.json content may be based on the following samples. Remember to update the configuration.values section to match what your integration expects.

Event types

Content

Video played (content.video_played)

{
  "configuration": {
    "bundleIdentifier": "tv.accedo.your.integration",
    "values": {
      "preshared-key": {
        "isOverridden": true,
        "secureString": {
          "decrypted": "super-secret",
          "encrypted": "PAa26vvdaJ/XwHxCG6e7Me7ySuPVGM2YTy+76vqna+hDV8"
        }
      }
    }
  },
  "details": {
    "content": {
      "contentId": "star-wars-ep-IV-12934014",
      "deviceId": "13237002-a903-4d21-9bab-a9dba3ed43d6",
      "objectSubtype": "VIDEO",
      "type": "VIDEO_PLAYED",
      "userId": "d18366bc-e0da-4634-bbae-8e698b0fa2cb",
      "videoPlayed": {
        "duration": "2360s",
        "entitlementTags": [
          "gold",
          "one",
          "one-authenticated"
        ],
        "fullyWatched": "5034s",
        "lifecycle": "BEACON",
        "locale": "en",
        "via": [
          {
            "id": "01EPY3B06MWB08MZ86ST3S8FCS",
            "objectType": "COLLECTION"
          }
        ]
      }
    },
    "endUserRequestContext": {
      "applicationId": "01EVBF4KQY8PRD2EXAJY42QMNJ",
      "applicationVersion": "ac8c268db",
      "clientIp": "162.198.33.21",
      "clientVersion": "20260209113659-7e0ae460-snapshot",
      "deviceInfo": {
        "displayInfo": {
          "formFactor": "FORM_FACTOR_DESKTOP",
          "height": 895,
          "width": 1728
        },
        "hardwareInfo": {
          "manufacturer": "Apple/Macintosh",
          "model": "Safari",
          "version": "26.2"
        },
        "id": "13237002-a903-4d21-9bab-a9dba3ed43d6",
        "legal": {},
        "operatingSystemInfo": {
          "name": "Mac OS",
          "version": "10.15.7"
        }
      },
      "location": {
        "countryCode": "US",
        "metroCode": "623"
      },
      "platformBundleIdentifier": "tv.accedo.one.client.web",
      "platformIntegrationId": "01EJ67BDVJDZ2G9SZJ6RPAC8JS",
      "requestIds": [
        "4ef47e22-6c63-44e2-aa03-d07510d93d70",
        "5t1_SsHi_MNwTpNs4vl3KYQBIKc_01HOTyzEIc3_-XJh4qyQ2Qy1mQ=="
      ],
      "requestTimestamp": "2026-02-10T17:07:04.440387151Z",
      "sessionGuid": "ce75715e-fe0a-4a67-b5ee-071430dac75f",
      "userId": "d18366bc-e0da-4634-bbae-8e698b0fa2cb"
    }
  },
  "eventId": "d49c24bd-0cf4-48be-9345-45596d7bbd9d",
  "subject": {
    "universalId": "01EPCW6VRQQV7GWP6SGJ8PBGTX"
  },
  "timestamp": "2026-02-10T17:07:04.440387151Z"
}