Skip to content

SDK method

tools.sourceProspects

Source prospects. Convenience alias for source_prospects, forwarding to tinbox.api.outreach.sourceProspects.mutate.

Signature

ts
sourceProspects(input: Parameters<TinboxTools["sourceProspects"]>[0]): ReturnType<TinboxTools["sourceProspects"]>

Parameters

NameTypeRequiredDescription
campaignIdstringyesThe outreach campaign id.
domainsstring[]noExplicit org apexes to qualify, e.g. ['acme.dev', 'globex.io'].
contactsQuerystringnoA Contacts search (email/name) → their org apexes.
dnsOnlybooleannoDNS-only qualification (skip page scrapes — faster, no emails extracted).
maxDomainsnumbernoCap the candidate apexes qualified this call.
skillIdstringnoSource via a tenant agentic skill instead of the GTM qualifier (e.g. 'founder-spotter' to scrape Show HN). The skill returns the prospects.
skillInputobjectnoJSON input for the sourcing skill's run (e.g. { query, limit, minPoints }).

Returns

ReturnType<TinboxTools["sourceProspects"]>

Example

ts
await tinbox.tools.sourceProspects({
  "campaignId": "<campaignId>"
});