Skip to main content
POST
Contact Research

Authorizations

Authorization
string
header
required

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

Body

application/json
contacts
string
required

Flexible formats: 'Name ', '[email protected]', or 'Name'. Comma-separated for multiple contacts. Examples: 'John Doe [email protected], [email protected], Bob Smith'

mode
enum<string>
default:thorough
required

Fast (~15-20s): basic profile, 2 retries. Thorough (~30-60s): verification scoring, 5 retries, authoritative sources.

Available options:
thorough,
fast
output_variable_name
string
default:contact_research_results
required

Variable name to store the research results.

Pattern: ^[a-zA-Z][a-zA-Z0-9_]*$
with_company_context
boolean
default:false

Also research the contact's company for cross-validation and richer context.

output_format
enum<string>
default:json

JSON returns structured data, Markdown returns formatted text, HTML generates a styled report via AI.

Available options:
json,
markdown

Response

Successful response

status
integer<int32>

HTTP status code of the action response

response
object

Response data from the action