Create a credential interaction

Creates a new credential interaction event.

<Callout title="Important considerations" type="warn"> This feature uses the browser's `LocalStorage` to identify the actions made by the recipient of the credential. When the user accesses the page with `?recipient=true` query parameter, the application saves that information in `LocalStorage` and removes the parameter from the URL. Actions taken afterwards in the same browser are recorded as the recipient's, until the `LocalStorage` data is cleared.

If you are distributing the credential links independently and wish to track events as originating from the recipient, be sure to include the ?recipient=true parameter. Without this parameter, we won't be able to mark this person as the recipient, and their actions will be marked under the guest actor category.

This approach may not capture every scenario. For example, if a recipient opens a link with ?recipient=true on one device, then shares the link without the parameter (or opens it on a different device without the stored flag), those subsequent views will be categorized as guest. Similarly, if the user clears their LocalStorage or uses an incognito session, the system can no longer confirm that they are the recipient.

</Callout>

{
  "credentialId": "01hrsvjp560yksep2a3bek3z97",
  "eventType": "credential_viewed",
  "triggeredBy": "recipient",
  "triggeredAt": "2024-03-12T17:33:05.784Z"
}

{
  "id": "01hrsvk8xnj8vkt8p1e2tc1jt7",
  "credentialId": "01hrsvjp560yksep2a3bek3z97",
  "eventType": "credential_viewed",
  "triggeredBy": "recipient",
  "triggeredAt": "2024-03-12T17:33:05.784Z"
}