Mailbox API – Contacts

folderId

String

The folder ID

When missing, all contacts from all contact folders are returned.

sort

String

"name", “email”

The sorting field

Default value: last provided value or "name" if not yet set

dir

String

"ASC", "DESC"

The sorting direction

Default value: last provided value or "DESC" if not yet set

start

Number

The starting position

Default value: 0

limit

Number

The maximum number of retrieved items

Default value: the WebMailData pageSize

syncTokenOnly

Boolean

When true, the endpoint should only return the syncToken without the list of contacts.

Default value: false

query

String

*

The search query string

limit

Number

1-50

Number of results.

Default value: 10.

contactEmailAddresses

Array

*

Example:

The contact email addresses.

The avatar is retrieved from the first contact matching the query parameter (there may be multiple contacts with that email address).

Matching is done by searching the provided contact email address as case insensitive substring in the main email address of the contacts (there is no match against “home”, “work”, or other secondary email address types).

contactIds

Array

*

Example:

The contact IDs.

See the id field of the Contact instance schema definition.