DocuSignInstall

Summary

Retrieves account brand configuration for a DocuSign account.

Inputs

• authentication — Authentication method to use for the DocuSign API request. Defaults to OAuth2 if not specified. Select JWT (Service Integration) for service account credentials. OAuth2 is the default and most common choice for workflows with interactive user consent or installed integrations configured with access tokens. JWT (Service Integration) requires a private key and integration key setup in the n8n credential configuration.
• accountId (required) — The DocuSign Account ID (GUID). This identifies the DocuSign account whose branding settings will be retrieved. Find the Account ID in DocuSign Admin → API and Keys. This field is mandatory for all account-scoped operations in the DocuSign node.
• brandId (required) — The ID of the brand whose configuration will be retrieved. In DocuSign, an account can have multiple branding configurations (e.g., different brands for different divisions or purposes). Provide the specific brand GUID or identifier here to fetch that brand's details, including logo, color scheme, and custom resources.
• category — The API category selector. Although the Account Brand resource has its own dedicated endpoint, this field appears in the UI and defaults to 'envelopes'. For the Get Account Brand operation, the category is effectively fixed to account-branding behavior, but the field remains available for consistency with the node's broader category-based filtering system. Selecting a different category may have no effect on this specific operation.

Output shape

The DocuSign API returns the branding configuration object for the specified account and brand. Typical fields include the brand name, primary and secondary colors, logo URL or binary data reference, custom tabs settings, and resource limits. The exact return shape depends on the DocuSign API version and the account's configured branding features. The operation does not modify any state; it is read-only.

Both accountId and brandId are required parameters. The authentication method selected must match the credentials configured in the n8n DocuSign credential setup. If OAuth2 is chosen, the workflow must have a valid OAuth2 access token in the execution context. If JWT is chosen, the associated service integration credential must provide a valid private key and integration key. The operation is idempotent and safe to run multiple times without side effects.

Examples

Example 1: A workflow needs to verify the current branding settings for a specific DocuSign account before proceeding with envelope creation.

Set authentication to OAuth2 (or JWT), provide the Account ID from DocuSign Admin, and specify the Brand ID to inspect. The node will return the brand's visual configuration, which can be checked via subsequent nodes or used in conditional logic.

Links

• n8n community nodes installation guide