Skip to main content
POST
Analyze Contact Email History & Insights

Authorizations

Authorization
string
header
required

Bearer token from your account (https://agent.ai/user/integrations#api)

Body

application/json
email_provider
enum<string>
default:gmail
required

Email service to search. Supports Gmail and Outlook Mail.

Available options:
gmail,
outlook
date_range_days
enum<string>
default:90
required

How far back to search for emails.

Available options:
1,
7,
30,
90
max_results
string
default:10
required

Maximum number of email threads to retrieve (e.g., 10, 50, 100).

Pattern: ^[0-9]+$
analysis_type
enum<string>
default:none
required

Optional AI analysis to run on the fetched emails.

Available options:
none,
timeline,
insights
output_variable_name
string
default:topic_relevant_gmail_threads
required

Provide a variable name to store the Gmail threads, like 'topic_relevant_gmail_threads' or 'contact_emails'.

Pattern: ^[a-zA-Z][a-zA-Z0-9_]*$
contact_email
string

The email address to search for (e.g., [email protected]). Will search in from, to, and cc fields.

meeting_topic
string

Topic or keywords to search for in emails (e.g., 'Q4 pricing proposal'). AI will extract relevant keywords.

Response

Successful response

status
integer<int32>

HTTP status code of the action response

response
object

Response data from the action