> ## 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.

# Dropbox

<div className="page-title-row">
  <img src="https://mintcdn.com/klef/xJ0kXbcegZOD2G3h/images/connectors/dropbox.svg?fit=max&auto=format&n=xJ0kXbcegZOD2G3h&q=85&s=ef6b0d9063d788ad9a35526c1f5a7897" alt="" noZoom width="24" height="24" data-path="images/connectors/dropbox.svg" />

  <h1>Dropbox</h1>
</div>

## Connection

Connecting sends you to Dropbox to approve Klef's access.

### Permissions

Minimum permissions the connection requires.

| Capability     | Required | Granted by (any one)                                                         |
| -------------- | -------- | ---------------------------------------------------------------------------- |
| Manage members | Yes      | `team_admin`, `user_management_admin`, `Team admin or User management admin` |
| Read groups    | Yes      | `groups.read`                                                                |

## dropbox.user

### Fields

| Field       | Type   | Required | Description                                                                                                                                   |
| ----------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `email`     | string | Yes      | Email address the invite goes to and the member signs in with. Klef does not change it.                                                       |
| `givenName` | string | Yes      | Given name.                                                                                                                                   |
| `surname`   | string | Yes      | Surname.                                                                                                                                      |
| `groups`    | grant  |          | Company-managed groups the member belongs to. One row grants one group.                                                                       |
| `groups[]`  | string |          | Group ID.                                                                                                                                     |
| `active`    | bool   |          | Whether the member can sign in. Switching it off suspends a member, keeping their files and license, or withdraws an invite not yet accepted. |

### Default Account Matching Rules

When Klef [adopts](/docs/adoption) an account that already exists in Dropbox, 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

### Dropbox members

A Dropbox invite for every employee, suspended with their files kept when they go, or withdrawn if never accepted.

```hcl theme={null}
stage active {
  target dropbox.user {
    email     = worker.business_email
    givenName = worker.legal_name.given
    surname   = worker.legal_name.family
    active    = true
  }
}
```