Skip to main content
POST
/
action
/
contact_research
Contact Research
curl --request POST \
  --url https://api-lr.agent.ai/v1/action/contact_research \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contacts": "<string>",
  "mode": "thorough",
  "output_variable_name": "contact_research_results",
  "with_company_context": false,
  "output_format": "json"
}
'
{
  "status": 123,
  "response": {}
}

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