> For the complete documentation index, see [llms.txt](https://beaker-browser.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://beaker-browser.gitbook.io/docs/apis/beaker.contacts.md).

# beaker.contacts

This API gives read access to the user's address book

### beaker.contacts.requestProfile()

Creates a dialog for selecting one of the user's profile drives.

* Returns **Promise\<Object>**
  * **url** String. The profile drive's URL.
  * **title** String. The profile drive's display name.
  * **description** String. The profile drive's bio.

```javascript
var profile = await beaker.contacts.requestProfile()
```

### beaker.contacts.requestContact()

Creates a dialog for selecting one of the user's contacts in their address book.

* Returns **Promise\<Object>**
  * **url** String. The profile drive's URL.
  * **title** String. The profile drive's display name.
  * **description** String. The profile drive's bio.

```javascript
var contact = await beaker.contacts.requestContact()
```

### beaker.contacts.requestContacts()

Creates a dialog for selecting multiple of the user's contacts in their address book.

* Returns **Promise\<Array\<Object>>**
  * **url** String. The profile drive's URL.
  * **title** String. The profile drive's display name.
  * **description** String. The profile drive's bio.

```javascript
var contacts = await beaker.contacts.requestContacts()
```

### beaker.contacts.list()

Returns the full list of contacts in the address book. Requires user permission.

* Returns **Promise\<Array\<Object>>**
  * **url** String. The profile drive's URL.
  * **title** String. The profile drive's display name.
  * **description** String. The profile drive's bio.

```javascript
var contacts = await beaker.contacts.list()
```