The following data collection process events can be subscribed to by your application.

Event codeDescription
dc_email_deliveredOccurs when an email has been delivered to a recipient email server who is completing a data collection process
dc_recipient_first_openedOccurs when a recipient has first opened their data collection process

dc_email_delivered

FieldTypeDescription
idstring (uuid)See How do I secure my notification URL?
algstringSee How do I secure my notification URL?
sentAtdate (ISO 8601-1:2019)When the notification was sent
eventstring"dc_email_delivered"
email_eventstringSee remarks
email_idstringThe email message ID
email_recipient_smtpstringThe recipient SMTP email address
recipient_idstring (uuid)The recipient ID
recipient_referencestringOptional. Round-trip reference of the recipient originally supplied by you
file_idstring (uuid)File UUID
file_referencestringFile reference of the the file

Remarks

email_event types

Event codeDescription
dc_inviteAn invitation email to begin a data collection process. The event can be re-raised if the invite email is sent again, the recipient email address changed or if the file is re-issued.

dc_recipient_first_opened

FieldTypeDescription
idstring (uuid)See How do I secure my notification URL?
algstringSee How do I secure my notification URL?
sentAtdate (ISO 8601-1:2019)When the notification was sent
eventstring"dc_recipient_first_opened"
recipient_idstring (uuid)The Finch recipient ID who first opened
recipient_referencestringOptional. Round-trip reference of the recipient originally supplied by you
file_idstring (uuid)File UUID
file_referencestringFile reference of the the file