Outlook
Read email correspondence by address
Read your email correspondence with a specific address.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| emailAddressstring · required | string | required | The other party's email address. Returns the FULL correspondence with this address across ALL threads in the connected Gmail/Outlook mailboxes — both messages received FROM them and messages sent TO them, each flagged with isFromMe/direction. |
| limitnumber · optional | number | optional | Max emails to return, newest first (default 100). Default: |
| sincestring · optional | string | optional | Only emails dated at or after this ISO date or date-time (e.g. "2026-09-22"). Use it for "in the last N days" questions, or to see whether they replied after a given email. Example: |
| untilstring · optional | string | optional | Only emails dated before this ISO date or date-time (exclusive). |
| accountIdstring · optional | string | optional | Optional: restrict to one connected email account (its account ID). Omit to search all email accounts in the workspace. |
| triggerThreadIdstring · optional | string | optional | Optional: the thread id from the trigger context. When provided, each email is flagged sameThreadAsTrigger so the agent can distinguish a same-thread reply from a follow-up in a different thread. |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"emailAddress",
"messageCount",
"emails"
],
"properties": {
"emails": {
"type": "array",
"items": {
"type": "object",
"required": [
"datetime",
"from",
"to",
"subject",
"content",
"threadId",
"messageId",
"sameThreadAsTrigger",
"isFromMe",
"direction",
"sent_via",
"sent_by_workflow_id",
"sent_by_workflow_name"
],
"properties": {
"to": {
"type": "array",
"items": {
"type": "string"
}
},
"from": {
"type": "string"
},
"content": {
"type": "string"
},
"subject": {
"type": [
"string",
"null"
]
},
"datetime": {
"type": "string"
},
"isFromMe": {
"type": "boolean"
},
"sent_via": {
"enum": [
"workflow",
"manual",
"external",
"unknown"
],
"type": "string"
},
"threadId": {
"type": [
"string",
"null"
]
},
"direction": {
"enum": [
"sent",
"received"
],
"type": "string"
},
"messageId": {
"type": [
"string",
"null"
]
},
"sameThreadAsTrigger": {
"type": [
"boolean",
"null"
]
},
"sent_by_workflow_id": {
"type": [
"string",
"null"
]
},
"sent_by_workflow_name": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"window": {
"type": "object",
"properties": {
"since": {
"type": "string"
},
"until": {
"type": "string"
}
},
"description": "The date window applied (UTC), present only when since/until was passed.",
"additionalProperties": false
},
"emailAddress": {
"type": "string"
},
"messageCount": {
"type": "number"
}
},
"additionalProperties": false
}