# `DocuSign.Api.ConnectConfigurations` [🔗](https://github.com/neilberkman/docusign_elixir/blob/v3.4.0/lib/docusign/api/connect_configurations.ex#L5) API calls for all endpoints tagged `ConnectConfigurations`. # `connect_delete_connect_config` ```elixir @spec connect_delete_connect_config( DocuSign.Connection.t(), String.t(), String.t(), keyword() ) :: {:ok, nil} | {:error, Req.Response.t()} ``` Deletes the specified Connect configuration. Deletes the specified Docusign Connect configuration. To use this method, you must be an account administrator and Connect must be enabled on your account. ### Parameters - `connection` (DocuSign.Connection): Connection to server - `account_id` (String.t): The external account number (int) or account ID GUID. - `connect_id` (String.t): The ID of the custom Connect configuration being accessed. - `opts` (keyword): Optional parameters ### Returns - `{:ok, nil}` on success - `{:error, Req.Response.t}` on failure # `connect_get_connect_all_users` ```elixir @spec connect_get_connect_all_users( DocuSign.Connection.t(), String.t(), String.t(), keyword() ) :: {:ok, DocuSign.Model.IntegratedConnectUserInfoList.t()} | {:error, Req.Response.t()} ``` Returns all users from the configured Connect service. Returns all users from the configured Connect service. To use this method, you must be an account administrator and Connect must be enabled on your account. ### Parameters - `connection` (DocuSign.Connection): Connection to server - `account_id` (String.t): The external account number (int) or account ID GUID. - `connect_id` (String.t): The ID of the custom Connect configuration being accessed. - `opts` (keyword): Optional parameters - `:count` (String.t): The maximum number of results to return. - `:domain_users_only` (String.t): - `:email_substring` (String.t): Filters returned user records by full email address or a substring of email address. - `:start_position` (String.t): The position within the total result set from which to start returning values. The value **thumbnail** may be used to return the page image. - `:status` (String.t): The status of the item. - `:user_name_substring` (String.t): Filters results based on a full or partial user name. **Note:** When you enter a partial user name, you do not use a wildcard character. ### Returns - `{:ok, DocuSign.Model.IntegratedConnectUserInfoList.t}` on success - `{:error, Req.Response.t}` on failure # `connect_get_connect_config` ```elixir @spec connect_get_connect_config( DocuSign.Connection.t(), String.t(), String.t(), keyword() ) :: {:ok, DocuSign.Model.ConnectConfigResults.t()} | {:error, Req.Response.t()} ``` Gets the details about a Connect configuration. Retrieves the information for the specified Docusign Connect configuration. To use this method, you must be an account administrator and Connect must be enabled on your account. ### Parameters - `connection` (DocuSign.Connection): Connection to server - `account_id` (String.t): The external account number (int) or account ID GUID. - `connect_id` (String.t): The ID of the custom Connect configuration being accessed. - `opts` (keyword): Optional parameters ### Returns - `{:ok, DocuSign.Model.ConnectConfigResults.t}` on success - `{:error, Req.Response.t}` on failure # `connect_get_connect_configs` ```elixir @spec connect_get_connect_configs(DocuSign.Connection.t(), String.t(), keyword()) :: {:ok, DocuSign.Model.ConnectConfigResults.t()} | {:error, Req.Response.t()} ``` Get Connect configuration information. Retrieves all the Docusign Custom Connect definitions for the specified account. To use this method, you must be an account administrator and Connect must be enabled on your account. ### Parameters - `connection` (DocuSign.Connection): Connection to server - `account_id` (String.t): The external account number (int) or account ID GUID. - `opts` (keyword): Optional parameters ### Returns - `{:ok, DocuSign.Model.ConnectConfigResults.t}` on success - `{:error, Req.Response.t}` on failure # `connect_get_connect_users` ```elixir @spec connect_get_connect_users( DocuSign.Connection.t(), String.t(), String.t(), keyword() ) :: {:ok, DocuSign.Model.IntegratedUserInfoList.t()} | {:error, Req.Response.t()} ``` Returns users from the configured Connect service. Returns users from the configured Connect service. To use this method, you must be an account administrator and Connect must be enabled on your account. ### Parameters - `connection` (DocuSign.Connection): Connection to server - `account_id` (String.t): The external account number (int) or account ID GUID. - `connect_id` (String.t): The ID of the custom Connect configuration being accessed. - `opts` (keyword): Optional parameters - `:count` (String.t): The maximum number of results to return. Use `start_position` to specify the number of results to skip. - `:email_substring` (String.t): Filters returned user records by full email address or a substring of email address. - `:list_included_users` (String.t): - `:start_position` (String.t): The zero-based index of the result from which to start returning results. Use with `count` to limit the number of results. The default value is `0`. - `:status` (String.t): Filters the results by user status. You can specify a comma-separated list of the following statuses: * ActivationRequired * ActivationSent * Active * Closed * Disabled - `:user_name_substring` (String.t): Filters results based on a full or partial user name. **Note:** When you enter a partial user name, you do not use a wildcard character. ### Returns - `{:ok, DocuSign.Model.IntegratedUserInfoList.t}` on success - `{:error, Req.Response.t}` on failure # `connect_o_auth_config_delete_connect_o_auth_config` ```elixir @spec connect_o_auth_config_delete_connect_o_auth_config( DocuSign.Connection.t(), String.t(), keyword() ) :: {:ok, nil} | {:error, Req.Response.t()} ``` Delete the Connect OAuth configuration. Deletes the Connect OAuth configuration for the specified account. To use this method, you must be an account administrator and Connect must be enabled on your account. ## Related topics: - [OAuth for Docusign Connect](/platform/webhooks/connect/validation-and-security/oauth-connect/) ### Parameters - `connection` (DocuSign.Connection): Connection to server - `account_id` (String.t): The external account number (int) or account ID GUID. - `opts` (keyword): Optional parameters ### Returns - `{:ok, nil}` on success - `{:error, Req.Response.t}` on failure # `connect_o_auth_config_get_connect_o_auth_config` ```elixir @spec connect_o_auth_config_get_connect_o_auth_config( DocuSign.Connection.t(), String.t(), keyword() ) :: {:ok, DocuSign.Model.ConnectOAuthConfig.t()} | {:error, Req.Response.t()} ``` Retrieves the Connect OAuth information for the account. Gets the Connect OAuth configuration for the specified account. To use this method, you must be an account administrator and Connect must be enabled on your account. ## Related topics: - [OAuth for Docusign Connect](/platform/webhooks/connect/validation-and-security/oauth-connect/) ### Parameters - `connection` (DocuSign.Connection): Connection to server - `account_id` (String.t): The external account number (int) or account ID GUID. - `opts` (keyword): Optional parameters ### Returns - `{:ok, DocuSign.Model.ConnectOAuthConfig.t}` on success - `{:error, Req.Response.t}` on failure # `connect_o_auth_config_post_connect_o_auth_config` ```elixir @spec connect_o_auth_config_post_connect_o_auth_config( DocuSign.Connection.t(), String.t(), keyword() ) :: {:ok, DocuSign.Model.ConnectOAuthConfig.t()} | {:error, Req.Response.t()} ``` Set up Connect OAuth for the specified account. Sets up Connect OAuth for the specified account using an authorization server of your choice. To use this endpoint, get the client ID and client secret from your authorization server. When you call this endpoint, Docusign requests an access token from your authorization server. Docusign will use that token in the Authorization HTTP header of your account's Connect messages. Finally, your listener will be responsible for validating the token by calling the authorization server. To use this method, you must be an account administrator and Connect must be enabled on your account. ## Related topics: - [OAuth for Docusign Connect](/platform/webhooks/connect/validation-and-security/oauth-connect/) ### Parameters - `connection` (DocuSign.Connection): Connection to server - `account_id` (String.t): The external account number (int) or account ID GUID. - `opts` (keyword): Optional parameters - `:body` (ConnectOAuthConfig): ### Returns - `{:ok, DocuSign.Model.ConnectOAuthConfig.t}` on success - `{:error, Req.Response.t}` on failure # `connect_o_auth_config_put_connect_o_auth_config` ```elixir @spec connect_o_auth_config_put_connect_o_auth_config( DocuSign.Connection.t(), String.t(), keyword() ) :: {:ok, DocuSign.Model.ConnectOAuthConfig.t()} | {:error, Req.Response.t()} ``` Updates the existing Connect OAuth configuration for the account. ### Parameters - `connection` (DocuSign.Connection): Connection to server - `account_id` (String.t): The external account number (int) or account ID GUID. - `opts` (keyword): Optional parameters - `:body` (ConnectOAuthConfig): ### Returns - `{:ok, DocuSign.Model.ConnectOAuthConfig.t}` on success - `{:error, Req.Response.t}` on failure # `connect_post_connect_configuration` ```elixir @spec connect_post_connect_configuration( DocuSign.Connection.t(), String.t(), keyword() ) :: {:ok, DocuSign.Model.ConnectCustomConfiguration.t()} | {:error, Req.Response.t()} ``` Creates a Connect configuration. Creates a custom Connect configuration for the specified account. To use this method, you must be an account administrator and Connect must be enabled on your account. Connect is a webhook service that provides updates when certain events occur in your eSignature workflows. You can use this endpoint to create: * Account-level Connect configurations to listen for events related to any envelopes sent by one or more account users * Recipient Connect configurations that are triggered when one or more of your account users receive an envelope To set an account-level configuration, set `configurationType` to **custom.** To set a Recipient Connect configuration, set `configurationType` to **customrecipient.** If you want to listen for events on only one envelope, use the [eventNotification](/docs/esign-rest-api/reference/envelopes/envelopes/create/#schema__envelopedefinition_eventnotification) object instead. ## Data models There are four possible data models for your Connect configuration. Consider: * Do you want the data in JSON or XML? * Do you want events sent individually (SIM) or in aggregate? Docusign recommends using the [JSON SIM event model](/platform/webhooks/connect/json-sim-event-model/).

JSON SIM (Recommended)

Set `deliveryMode` to **SIM** and `eventData.version` to **restv2.1.** Use the `events` property to set the event statuses that will trigger your configuration. The following sample request shows how to create an envelope-level configuration using JSON SIM: ``` { "configurationType": "custom", "urlToPublishTo": "YOUR-WEBHOOK-URL", "allUsers": "true", "name": "jsonSimTest", "deliveryMode": "SIM", "allowEnvelopePublish": "true", "enableLog": "true", "eventData": { "version": "restv2.1" }, "events": [ "envelope-sent", "envelope-delivered", "envelope-completed" ] } ``` The following sample request shows how to create a Recipient Connect configuration using JSON SIM: ``` { "configurationType": "customrecipient", "urlToPublishTo": "YOUR-WEBHOOK-URL", "allUsers": "true", "name": "jsonSimTest", "deliveryMode": "SIM", "allowEnvelopePublish": "true", "enableLog": "true", "eventData": { "version": "restv2.1" }, "events": [ "recipient-sent", "recipient-completed" ] } ```

JSON Aggregate

Set `deliveryMode` to **aggregate** and `eventData.version` to **restv2.1.** Use the `envelopeEvents` or `recipientEvents` property to set the event statuses that will trigger your configuration.

XML Aggregate

Set `deliveryMode` to **aggregate.** Use the `envelopeEvents` or `recipientEvents` property to set the event statuses that will trigger your configuration.

XML SIM (Legacy apps only)

**Note:** This model [is deprecated](https://www.docusign.com/blog/developers/docusign-connect-xml-sim-messaging-format-deprecated). Set `deliveryMode` to **SIM.** Use the `envelopeEvents` or `recipientEvents` property to set the event statuses that will trigger your configuration.
## Troubleshooting If your configuration is not working, check the following. * Connect must be enabled for your account to use this function. * If you are using `envelopeEvents` or `recipientEvents`, make sure that the event values are sentence case, not lowercase. * Make sure you have either set `allUsers` to **true** or set `userIds` to a non-empty array of IDs. * By default, this endpoint creates a disabled configuration. To enable the configuration immediately, set the body parameter `allowEnvelopePublish` to **true.** You can also enable the configuration in the UI. * To check if events are being emitted, set `enableLog` to **true** to view event logs in the Connect console. ## Related topics * For more information about Connect, see the [Docusign Connect guide](/platform/webhooks/connect/). * Use the MyAPICalls sample app to see an [example of this endpoint](https://myapicalls.sampleapps.docusign.com/scenario/6) using the JSON SIM model. ### Parameters - `connection` (DocuSign.Connection): Connection to server - `account_id` (String.t): The external account number (int) or account ID GUID. - `opts` (keyword): Optional parameters - `:body` (ConnectCustomConfiguration): ### Returns - `{:ok, DocuSign.Model.ConnectCustomConfiguration.t}` on success - `{:error, Req.Response.t}` on failure # `connect_put_connect_configuration` ```elixir @spec connect_put_connect_configuration( DocuSign.Connection.t(), String.t(), keyword() ) :: {:ok, DocuSign.Model.ConnectCustomConfiguration.t()} | {:error, Req.Response.t()} ``` Updates a specified Connect configuration. Updates the specified Docusign Connect configuration in your account. To enable the configuration, set the `allowEnvelopePublish` property to **true.** After any updates, test your configuration to make sure it works as expected. To use this method, you must be an account administrator and Connect must be enabled on your account. ### Parameters - `connection` (DocuSign.Connection): Connection to server - `account_id` (String.t): The external account number (int) or account ID GUID. - `opts` (keyword): Optional parameters - `:body` (ConnectCustomConfiguration): ### Returns - `{:ok, DocuSign.Model.ConnectCustomConfiguration.t}` on success - `{:error, Req.Response.t}` on failure --- *Consult [api-reference.md](api-reference.md) for complete listing*