> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL.
>
> Documentation indexes by section:
> - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt
> - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt
> - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt
> - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt
>
> Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth
> Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks
>
> OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json
> MCP server: https://docusign.docs.buildwithfern.com/_mcp/server

# GetConnectFailures

GetConnectFailures retrieves a list of Connect post failures for the account and date range specified.

### Schema

![](/_fern-files/_img/eb2576e045eb352a89053c99f732283b85afedd74e374f4657ece0d273571d31.webp)

**`Sample request XML`**

```php title="Sample request XML"
SOAPAction: "http://www.docusign.net/API/3.0/GetConnectFailures"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetConnectFailures xmlns="http://www.docusign.net/API/3.0">
      <ConnectFailuresFilter>
        <AccountId>string</AccountId>
        <DateFrom>dateTime</DateFrom>
        <DateTo>dateTime</DateTo>
      </ConnectFailuresFilter>
    </GetConnectFailures>
  </soap:Body>
</soap:Envelope>
```

| Name      | Schema Type | Description                                                   |
| --------- | ----------- | ------------------------------------------------------------- |
| AccountId | String      | The account ID for the requested Connect post failures.       |
| DateFrom  | dateTime    | The start date and time for the Connect post failures search. |
| DateTo    | dateTime    | The end date and time for the Connect post failures search.   |

This method returns GetConnectFailureResults with an array of ConnectFailures. Each ConnectFailure instance has the elements shown below.

| Name           | Schema Type | Description                                                                                                                                                                                  |
| -------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| EnvelopeId     | String      | The envelope ID of the envelope status that failed to post.                                                                                                                                  |
| AccountId      | String      | The account ID associated with the envelope.                                                                                                                                                 |
| Failed         | dateTime    | The date and time the original Connect post failed.                                                                                                                                          |
| Retried        | dateTime    | The date and time the last attempt to post.                                                                                                                                                  |
| RetryCount     | Integer     | The number of times the Connect post has been retried.                                                                                                                                       |
| EnvelopeStatus |             | The new envelope status for the failed Connect post. The possible values are: Any, Voided, Created, Deleted, Sent, Delivered, Signed, Completed, Declined, TimedOut, Template, or Processing |
| Sender         | String      | The name of the envelope sender.                                                                                                                                                             |
| Email          | String      | The email that sent the envelope.                                                                                                                                                            |
| Subject        | String      | The envelope subject.                                                                                                                                                                        |
| Error          | String      | The error that caused the Connect post to fail.                                                                                                                                              |
| ConfigId       | String      | The identifier for the Connect configuration that failed. If an account has multiple Connect configurations, this value is used to to look up the Connect configuration for the failed post. |
| ConfigUrl      | String      | The web address of the listener or Retrieving Service end point for Connect.                                                                                                                 |