Create an AI List
AI Lists
Create an AI List
Create an AI-powered list generation job. The AI will search your workspace and generate a list of records matching your natural language query. Use the returned job_id to poll for results.
POST
Create an AI List
Authorizations
API key for authentication (format: "Bearer YOUR_API_KEY")
Body
application/json
AI list generation parameters
Natural language query to search items (e.g., 'all companies', 'high priority contacts')
Type of object to search - 'contact' or 'company' (default: 'contact')
Number of results (default: 50, max: 100)
If true, includes all entity attribute values in response (default: false)
Response
Job created successfully
Response wrapper
Last modified on March 26, 2026