> ## Documentation Index
> Fetch the complete documentation index at: https://klef.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Docusign User Provisioning & Deprovisioning

> Automate Docusign user provisioning and deprovisioning from your HRIS. Klef creates, updates, and deactivates accounts when HR makes a change.

![](https://mintcdn.com/klef/O1Sswmcb_uCGkmIf/images/connectors/docusign.svg?fit=max\&auto=format\&n=O1Sswmcb_uCGkmIf\&q=85\&s=4a6ab7abf21205fb7a53cedeb523de37)

# Docusign

## Connection

Saving the settings sends you to Docusign to approve your application's access.

To connect a Docusign sandbox, choose **Sandbox** when you connect.

### Setup

Klef connects to Docusign eSignature as an administrator of the account.

**Step 1**

Choose **Connect** and sign in to Docusign as an administrator of the account Klef should manage. For a developer account, choose the developer sign-in.

**Step 2**

If you belong to more than one account, enter the **API Account ID** of the one to manage. You can find it in Docusign under **Settings**, then **Apps and Keys**. Leave it empty to use your default account.

Docusign emails each new user an activation link. Every user belongs to the Everyone group, so Klef does not offer it.

Docusign never deletes a user. Switching a user off deactivates them.

### Settings

| Setting | Required | Description |
| - | - | - |
| Account ID | | API Account ID of the account to manage. Leave it empty for their default account. |

## docusign.user

### Fields

| Field | Type | Required | Description |
| - | - | - | - |
| `email` | string | Yes | Email address the user signs in with, where Docusign sends the activation. The connector does not change it once the user exists. Never changed once the account exists. |
| `name` | string, up to 100 | Yes | Full name, which Docusign shows on envelopes. |
| `firstName` | string, up to 50 | | First name. |
| `lastName` | string, up to 50 | | Last name. |
| `permissionProfile` | string | | Permission profile ID. Docusign gives a new user the account's default when this is left out. |
| `groups` | entitlements | | Groups the user belongs to. Docusign puts every user in Everyone, so the connector does not offer it. One row grants one group. |
| `groups[]` | string | | Group ID. |
| `active` | bool | | Whether the user can sign in. The connector closes a user it removes, which keeps their envelopes, and opens them again if they come back. Shows the account's status: a policy reads it and sets `status` instead. |
| `status` | enum | | Whether the person can sign in, the account is kept switched off, or the account is gone. Values: `enabled` (Enabled), `disabled` (Disabled). |

### Default Account Matching Rules

When Klef [adopts](https://klef.ai/docs/adoption.md) an account that already exists in Docusign, it works out whose it is by trying these in order. A connection can override them.

| Account field | Worker field |
| - | - |
| `email` | `worker.business_email` |

## Examples

### Docusign users

A Docusign user for each person in sales, closed when they leave.

```hcl theme={null}
stage active {
  target docusign.user {
    email     = worker.business_email
    name      = worker.display_name
    firstName = worker.legal_name.given
    lastName  = worker.legal_name.family
    status    = enabled
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.