List customer emails
list_customer_emailsLists the customer emails in one store's connected mailbox, 20 per page: to answer (answer), sorted for a person (needs_you) or sent. Each row has the subject, the sender's name and masked address, the topic, the status and whether a draft is ready. Needs the conversations permission and the store's switch for AI assistants in Settings > Security, and works only for stores the person owns.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"store_id": "<store_id>"
},
"name": "list_customer_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tab | No | answer | |
| page | No | ||
| topic | No | ||
| period | No | The days covered, by when the conversation or email arrived. | 30d |
| search | No | ||
| store_id | Yes | The store's store_id (not its name). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ||
| tab | No | ||
| from | No | ||
| more | No | ||
| page | No | ||
| counts | Yes | ||
| emails | Yes | ||
| store_id | Yes | ||
| dashboard_url | No | ||
| mailbox_connected | No |