# openemail.mailboxShares

Sharing a mailbox with other identities: grant and revoke their access, list who has it, and list the mailboxes shared with you.

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

| Method | What it does | It calls |
| --- | --- | --- |
| [`mailboxShares.grant`](/docs/sdks/typescript/mailbox-shares/grant) | Give another user access to this mailbox | [`PUT /mailboxes/{mailboxId}/shares/{granteeIdentityId}`](/docs/api/mailboxes/put_MailSharePut) |
| [`mailboxShares.revoke`](/docs/sdks/typescript/mailbox-shares/revoke) | Remove another user's access to this mailbox | [`DELETE /mailboxes/{mailboxId}/shares/{granteeIdentityId}`](/docs/api/mailboxes/delete_MailShareDelete) |
| [`mailboxShares.list`](/docs/sdks/typescript/mailbox-shares/list) | List who has access to this mailbox | [`GET /mailboxes/{mailboxId}/shares`](/docs/api/mailboxes/get_MailShareList) |
| [`mailboxShares.listSharedWithMe`](/docs/sdks/typescript/mailbox-shares/list-shared-with-me) | List mailboxes shared with you | [`GET /shared-mailboxes`](/docs/api/mailboxes/get_SharedMailboxList) |

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