Captured leads
leads_recentThe email addresses and phone numbers HookSend has captured, newest first, each with the handle it came from, the campaign that collected it, where it was collected and any tags a flow put on that person. A lead carrying cameFrom is one whose conversation started on a click-to-DM ad or on a link tagged by the customer, said in a sentence — use it to answer which ad or which link is producing leads. Use it for 'show me my recent leads', 'how many leads did this campaign get', or to look somebody up by handle or email. The answer also lists the tags in use, so you can filter by one. This is personal data the customer owns: hand it back to them and nowhere else.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Only people carrying this tag. Tags are set by DM flows; the answer lists the ones in use. | |
| limit | No | How many leads to return, newest first. Defaults to 25; 100 is the most this tool will ever return. | |
| search | No | Matches part of an email address, a phone number or an Instagram handle. | |
| campaignId | No | Only leads collected by this campaign, using an id from campaigns_list. | |
| instagramAccountId | No | Narrow the answer to one connected Instagram account, using the id from account_instagram_accounts. Leave it out to cover every account in the workspace. |