Skip to main content
AI Ark logo
  • Category: hr talent & recruitment
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 19
  • Triggers: 0
  • Slug: AI_ARK
  • Version: 20261101_00

Tools

Slug: AI_ARK_ANALYZE_PERSONALITYInfer DISC and OCEAN personality assessments plus selling and hiring outreach guidance from one person’s LinkedIn profile. This costs 4 AI Ark credits per request and returns sensitive algorithmic inferences, not verified or objective facts.

Input Parameters

string
required
Full HTTPS LinkedIn person-profile URL with an /in/<profile> path.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_CREATE_OR_UPDATE_LISTCreate or mutate a temporary people/company exclusion list for free. Lists expire after 24 hours, hold at most 10,000 values, and are limited to 50 new lists per day. APPEND merges values; REPLACE irreversibly overwrites the complete prior list. Omitting list_id creates a list, and an unknown list_id can also create new state.

Input Parameters

string ("APPEND" | "REPLACE")
APPEND merges values into the list. REPLACE irreversibly overwrites all prior values.
array
required
Person or company IDs to store. At most 10,000 values; the provider allows an empty array.
string
Existing temporary list ID to update. Omit to create a list. An unknown ID creates new list state instead of failing.
string ("people_id" | "company_id")
Provider ID kind stored by the list. Required when list_id is omitted; allowed but not required when updating an existing ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_ENRICH_PERSON_WITH_EMAILEnrich one person by AI Ark person ID or LinkedIn URL with a full profile and provider email-verification metadata. This returns sensitive personal profile and email data and is an enrichment action, not a standalone email verifier. It costs 1 credit only when a valid email is found and 0 credits otherwise.

Input Parameters

string
AI Ark person ID from a people search or preview result. When both identifiers are supplied, AI Ark tries this ID first.
string
Full HTTPS LinkedIn person-profile URL used when person_id is absent or does not resolve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_FIND_MOBILE_PHONEFind candidate mobile phone numbers for one person from a LinkedIn URL or a company domain plus full name. AI Ark charges 5 credits per found phone number and 0 if none are found; the response contains sensitive personal numbers ordered by provider confidence.

Input Parameters

string
Person’s full name. Supply it together with company_domain and without linkedin_url.
string
Full HTTPS LinkedIn person-profile URL. Use this alone, or omit it and provide both company_domain and full_name.
string
Company domain. Supply it together with full_name and without linkedin_url.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_GET_CREDITSReturn the connected AI Ark account’s remaining credit balance for free; this is the only action safe to use for credential validation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_GET_EMAIL_FINDER_STATUSMake one free status request for an email-finder job and return its state and total/found counts. This action does not poll internally or start another billable lookup; call it again only when another status check is needed.

Input Parameters

string
required
Email-finder job track ID returned by START_EMAIL_FINDER.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_GET_PEOPLE_EXPORT_STATUSMake one free status request for a bulk people-export job and return its state, total/found/success/failed counts, and webhook metadata. This action does not poll internally; call it again only when another status snapshot is needed.

Input Parameters

string
required
People-export job track ID returned by START_PEOPLE_EXPORT.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_LIST_EMAIL_FINDER_RESULTSReturn one free page of an email-finder job’s results without waiting for completion. Entries still in PROCESSING state are preserved alongside completed entries. The response can contain sensitive personal email addresses, lookup inputs, and full provider verification and MX metadata.

Input Parameters

integer
Zero-based result page to return.
integer
Maximum result entries to return on this page.
string
required
Email-finder job track ID returned by START_EMAIL_FINDER.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_LIST_EMAIL_FINDER_SUBMISSIONSReturn one free page of the connected AI Ark customer’s email-finder submission history, including job states and refund details. The provider automatically scopes results to the authenticated API key; callers control filters, repeated sort criteria, and pagination, and this action makes one request without polling or automatic pagination.

Input Parameters

integer
Zero-based submission-history page to return.
integer
Number of submission summaries to return on this page.
array
Provider property names to sort by, for example created. Each item is sent as a repeated sort query parameter. The live API rejects the documented direction suffix form such as created,desc.
string ("PENDING" | "SETTLED")
Filter submissions by lifecycle state.
boolean
Filter by whether the submission was fully refunded.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_LIST_PEOPLE_EXPORT_RESULTSReturn one free page of a completed bulk people export. The response contains sensitive full person and company profiles and personal emails with provider verification metadata. This action does not poll internally; a still-processing export returns 409, so check GET_PEOPLE_EXPORT_STATUS until its state is DONE before trying again.

Input Parameters

integer
Zero-based result page to return.
integer
Number of people to return on this page.
string
required
Track ID returned by START_PEOPLE_EXPORT.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_LIST_PEOPLE_EXPORT_SUBMISSIONSList the authenticated API token’s own people-export submission and refund history for free. Results are automatically scoped to the caller’s customer account and this action returns one explicitly selected page without polling.

Input Parameters

integer
Zero-based submission-history page to return.
integer
Number of submission-history items to return on this page.
array
Provider property names to sort by, for example created. Each list item is sent as a separate sort query parameter. The live API rejects the documented direction suffix form such as created,desc.
string ("PENDING" | "SETTLED")
Filter submissions by lifecycle state.
boolean
Filter by whether AI Ark fully refunded the submission.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_LOOK_UP_PERSON_BY_EMAILIdentify and return a sensitive, detailed personal and employment profile from an email address. AI Ark charges 0.5 credits per request, including when no profile is found. This action does not verify the input email and does not return a mobile number.

Input Parameters

string
required
Email address used to identify the person. AI Ark does not verify this email, and this action does not accept phone numbers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_PREVIEW_PEOPLEReturn one page of masked people and full company matches for 1 credit per page. The preview contains no email or phone data and its trackId is null, so it cannot start email finding.

Input Parameters

integer
required
Required zero-based result page to return.
integer
required
Required records requested on this page. Each page costs 1 credit regardless of size.
object
Temporary people-list IDs whose members should be excluded.
object
Typed company filters to combine with person filters.
object
Typed person filters for the preview.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_RESEND_EMAIL_FINDER_WEBHOOKResend an email-finder completion payload to a caller-selected public HTTPS webhook for free, potentially disclosing sensitive personal emails and lookup inputs; the destination may differ from the original submission. Success is reported only when AI Ark explicitly confirms delivery.

Input Parameters

string
required
Track ID of the completed AI Ark job whose webhook should be resent.
string
required
Public HTTPS URL that will receive the job’s sensitive completion payload. This may differ from the original webhook URL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_RESEND_PEOPLE_EXPORT_WEBHOOKIrreversibly resend one completed bulk people export to a caller-selected public HTTPS webhook. This free action externally discloses sensitive full profiles and verified personal emails, may target a different URL from the original submission, and must not be retried after an ambiguous outcome. Success is reported only when AI Ark explicitly confirms delivery.

Input Parameters

string
required
Track ID of the completed AI Ark job whose webhook should be resent.
string
required
Public HTTPS URL that will receive the job’s sensitive completion payload. This may differ from the original webhook URL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_SEARCH_COMPANIESReturn one zero-based page of companies using typed company, employee, list, and lookalike filters, at 0.1 credits per returned company. Lookalike search accepts 1–5 domains or LinkedIn company URLs, page must be nonnegative, size 1–100, and up to 10,000 records are retrievable per search.

Input Parameters

integer
required
Required zero-based result page. Results are limited to the first 10,000 matches.
integer
required
Required companies requested on this page (1-100); each returned company costs 0.1 credits.
object
Temporary company-list IDs whose companies should be excluded.
object
Company filters, including employee title, seniority, and department criteria.
array
One to five company domains or LinkedIn company URLs used to find similar companies.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_SEARCH_PEOPLEReturn one page of full people and company profiles. This search costs 0.5 credits per returned person and does not return email addresses or phone numbers, but its personal and employment profile data is sensitive. The returned provider trackId (exposed as track_id) can be used once to start email finding and expires 6 hours after this search.

Input Parameters

integer
required
Required zero-based result page to return.
integer
required
Required maximum people to return on this page. Each returned person costs 0.5 credits.
object
Temporary people-list IDs whose members should be excluded.
object
Company filters for matching people.
object
Person profile and employment filters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_START_EMAIL_FINDERConsume a People Search track ID exactly once, within 6 hours of the search, to start email finding. A required external HTTPS webhook receives sensitive personal email results. This costs 1 credit per valid email found and 0 credits for people without a valid email. Use GET_EMAIL_FINDER_STATUS to monitor the job and LIST_EMAIL_FINDER_RESULTS to retrieve partial or completed results.

Input Parameters

string
required
Single-use track ID returned by SEARCH_PEOPLE. Submit it exactly once within 6 hours of the search; this action consumes it.
string
required
Public HTTPS URL that receives the completed email-finder results, which contain sensitive personal email data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AI_ARK_START_PEOPLE_EXPORTIrreversibly start one paid asynchronous export of up to 10,000 matching people and deliver full personal profiles with real-time verified emails to a required external HTTPS webhook. AI Ark charges 0.5 credits per exported person plus 0.5 credits per valid email found, so the explicit maximum charge is size credits. Do not retry an ambiguous outcome because a duplicate submission can incur another charge and external delivery.

Input Parameters

integer
required
Required zero-based starting search page for the export.
integer
required
Required total people to export. The maximum possible charge for this invocation is exactly size credits.
object
Temporary people-list IDs whose members should be excluded.
object
Company filters for matching people.
object
Person profile and employment filters.
string
required
Public HTTPS URL that receives the completed bulk export containing sensitive personal profiles and verified emails.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not