# openemail.identities

The identities of an account, its mailboxes and calendar-only users: create, list, read, update, delete and restore them, their addresses, the clients they…

The identities of an account, its mailboxes and calendar-only users: create, list, read, update, delete and restore them, their addresses, the clients they sign in with and their saved preferences.

Its 10 methods, each a page of its own, in the order the API reference presents them:

| Method | What it does | It calls |
| --- | --- | --- |
| [`identities.create`](/docs/sdks/typescript/identities/create) | Create an identity | [`POST /identities`](/docs/api/mailboxes/post_IdentityCreate) |
| [`identities.list`](/docs/sdks/typescript/identities/list) | List mailboxes | [`GET /identities`](/docs/api/mailboxes/get_IdentityList) |
| [`identities.get`](/docs/sdks/typescript/identities/get) | Get identity and bound store usage | [`GET /identities/{identityId}`](/docs/api/mailboxes/get_IdentityGet) |
| [`identities.update`](/docs/sdks/typescript/identities/update) | Update mailbox settings | [`PATCH /identities/{identityId}`](/docs/api/mailboxes/patch_IdentityUpdate) |
| [`identities.delete`](/docs/sdks/typescript/identities/delete) | Delete a mailbox | [`DELETE /identities/{identityId}`](/docs/api/mailboxes/delete_IdentityDelete) |
| [`identities.restore`](/docs/sdks/typescript/identities/restore) | Restore a deleted mailbox | [`POST /identities/{identityId}/restore`](/docs/api/mailboxes/post_IdentityRestore) |
| [`identities.listAddresses`](/docs/sdks/typescript/identities/list-addresses) | List an identity's addresses | [`GET /identities/{identityId}/addresses`](/docs/api/mailboxes/get_IdentityAddressList) |
| [`identities.listClients`](/docs/sdks/typescript/identities/list-clients) | List an identity's clients | [`GET /identities/{identityId}/clients`](/docs/api/credentials/get_IdentityClientList) |
| [`identities.getPreferences`](/docs/sdks/typescript/identities/get-preferences) | Get identity preferences | [`GET /identities/{identityId}/prefs`](/docs/api/mailboxes/get_PrefsGet) |
| [`identities.setPreferences`](/docs/sdks/typescript/identities/set-preferences) | Save identity preferences | [`PUT /identities/{identityId}/prefs`](/docs/api/mailboxes/put_PrefsPut) |

In the API reference: [Mailboxes](/docs/api/mailboxes), [Credentials](/docs/api/credentials).
