Hi everyone,

Since early 2025, I’ve been encountering a problem with the payload received via DocuSign Connect using API version 2.1 in JSON format.

Until recently, I was deserializing the notification using a well-defined C# object like this:


 

public class DocuSignEventNotificationResponse 
{ 
    public string status { get; set; } 
    public string envelopeId { get; set; } 
    public string documentsUri { get; set; } 
    public string recipientsUri { get; set; } 
    public Sender sender { get; set; } 
}

public class Sender 
{ 
    public string userName { get; set; } 
    public string userId { get; set; } 
    public string accountId { get; set; } 
    public string email { get; set; } 
}


However, recently the payload arriving in the DocuSign logs seems to have changed completely. For example, now I receive notifications in this format:

{
  "event": "envelope-completed",
  "apiVersion": "v2.1",
  "uri": "/restapi/v2.1/accounts/1e78c******8c2db/envelopes/18*******91dca",
  "retryCount": 1,
  "configurationId": 0,
  "generatedDateTime": "2025-07-16T09:49:25.5964409Z",
  "data": {
    "accountId": "1e*******c2db",
    "userId": "abcdde*******03ed7",
    "envelopeId": "1870944*********ca"
  }
}

It looks like the object used for deserialization has changed or there has been a modification in the notification format.

Has anyone else experienced the same issue?
What object do you recommend for deserializing this new format?
If possible, I would appreciate updated code examples or any official information from DocuSign about these changes.

Thanks a lot for your help!