Enqueue Dex AI contact discovery
Operation
POST
/advertisers/{id}/find_more_contacts
Enqueues a background job to search for additional company contacts and upsert them on the advertiser (same as the advertiser UI “find more contacts” / ImportCompanyPeopleWithAiJob). Requires admin or paid-publisher access to the advertiser (free-tier API users are not eligible). Responds immediately with 202 Accepted; use search_contacts to list contacts after processing.
findMoreContacts
·
Tags: Advertisers
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id
|
path | Yes | string | Advertiser ID or slug |
dry_run
|
query | No | boolean | When true, returns what would happen without enqueueing a job |
Request Body
No request body is defined for this operation.
Responses
Content Types
application/json
{
"description": "Dry run — no job enqueued",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"attributes": {
"type": "object"
}
}
}
}
}
}
}
}Content Types
application/json
{
"description": "Job enqueued on high_priority queue",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"advertiser_id": {
"type": "integer"
},
"status": {
"type": "string"
},
"queue": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
}
}
}
}
}
}
}{
"$ref": "#/components/responses/Unauthorized"
}{
"$ref": "#/components/responses/Forbidden"
}{
"$ref": "#/components/responses/NotFound"
}API Playground
The in-page tester only supports GET. For POST, use the sample curl below or the dedicated resource docs (e.g. Contacts, Link Builder).
Sign in to enable live testing with your API key.
| Action | Method | Endpoint | Description |
|---|---|---|---|
| Enqueue Dex AI contact discovery | POST |
/api/v1/advertisers/1/find_more_contacts |
OpenAPI operationId: findMoreContacts. |
Example request (replace YOUR_API_KEY or sign in above):
curl -X POST "https://app.hienergy.ai/api/v1/advertisers/1/find_more_contacts" \
-H "X-Api-Key: YOUR_API_KEY" \
-H "Accept: application/json"
-H "Content-Type: application/json" \
-d '{}'