# PimShare

The PimShare type of the TypeScript SDK, which calendars.grantAccess and 3 more methods take or answer.

```ts
type PimShare = {
  createdAt: number
  permission: ('read' | 'read-write')
  shareeAddress: string | null
  shareeIdentityId: string
}
```

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `createdAt` | `number` |  |
| `permission` | `('read' \| 'read-write')` | Access permission level |
| `shareeAddress` | `string` \| `null` | Primary email address of the sharee, or null for an address-less identity. Present so a sharing UI can name the grantee without a lookup per grant — the mirror of MailShare.granteeAddress |
| `shareeIdentityId` | `string` | Identity ULID granted access |

## Used by

| Method | What it does |
| --- | --- |
| [`calendars.grantAccess`](/docs/sdks/typescript/calendars/grant-access) | Grant calendar access |
| [`calendars.listAccess`](/docs/sdks/typescript/calendars/list-access) | List calendar access grants |
| [`addressbooks.grantAccess`](/docs/sdks/typescript/addressbooks/grant-access) | Grant addressbook access |
| [`addressbooks.listAccess`](/docs/sdks/typescript/addressbooks/list-access) | List addressbook access grants |
