Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.
BetaEssentials EditionPro EditionEnterprise Edition

Recruitment Agent

The Recruitment Agent automates partner recruitment for your program, using AI to source new prospects from the Marketplace and evaluate inbound applications on your behalf. It builds on the workflow-based recruitment approach. For the rule-based alternative, see Recruitment Workflows Explained. To get started, see Set Up the Recruitment Agent.

Understand how the agent works

The agent coordinates 3 sub-agents, and each one handles a specific part of the recruitment funnel. Each sub-agent card has a toggle. Set it to [Toggle on] to include the sub-agent in the funnel, or [Toggle off] to skip that part of the funnel. You configure each sub-agent independently. See the sub-agent sections below.

The agent works from a single set of instructions you control. For how to write and refine them, see Write Effective Agent Instructions.

Discover sub-agent

The Discover sub-agent uses the instructions you provide to source, evaluate, and organize new prospects from the impact.com Marketplace, and adds the best matches to your Prospects list.

Trigger Discovery manually by selecting Run Discover on the agent card, or set it to run on a schedule. While the sub-agent is busy, the button text changes to Running and the button is disabled. After a run completes, wait a few minutes for it to finish processing, then find the partners it added on the Prospects page by setting the Source filter to Recruitment Agent. See Track Recruitment Agent Results.

If you get a message that Run Discover is unavailable, a tooltip tells you that you have used all your Discovery runs for the current 24-hour period. You can run Discovery again when that period ends.

If a Discovery run returns very few or no matches, loosen your instructions. Edit them and run Discovery again.

When Discovery runs, the sub-agent searches the Marketplace, evaluates candidates against your instructions, and adds the best matches to your Prospects list with Source = Recruitment Agent, in the group you set under Assign groups. For each prospect it adds, the agent leaves a note in the partner's Activity log explaining why the prospect is a good fit. See View Prospective Partners.

When the sub-agent determines a partner isn't a match, it skips them on future runs for 6 months or until you update your instructions, whichever comes first. This keeps Discovery efficient by avoiding the re-evaluation of partners you have already ruled out. Because a change in your instructions means your matching criteria have changed, the entire skip list is automatically reset.

The Discover sub-agent comes pre-configured. You can review and edit its sourcing channels, group assignment, schedule, and run limit before you activate the agent. See Set Up the Recruitment Agent.

Evaluate Applications sub-agent

The Evaluate Applications sub-agent automatically evaluates incoming partner applications using the rules in your instructions, with the option to safeguard uncertain matches.

When Quality & Safety Guardrails is on, only partners that meet the platform’s Marketplace safety standards are evaluated by the agent. By default, applications from partners that don’t meet these standards are rejected, which you can change with the Fallback if Quality & Safety Guardrails Fail setting. The agent applies this fallback immediately, in both Autopilot and Copilot, and assigns the application to a group that shows why it was rejected or left pending. The Evaluate Applications card shows Required when Quality & Safety Guardrails is on, and Not required when it is off. See Evaluate Applications settings.

The sub-agent runs on every inbound application, so you do not trigger it manually. It makes decisions within seconds of the application being submitted.

You set how much autonomy the sub-agent has:

  • Autopilot (recommended): the agent compares each application against your instructions and the partner's data, then accepts or rejects clear matches and leaves ambiguous applications for your team to review.

  • Copilot: the agent recommends accepting or rejecting each application by assigning it to a group, and you make the final decision from the Applications page. If you don't act within 7 days, the agent applies its recommendation for you. See Review Partner & Creator Applications.

If you are getting started, use Copilot mode so you can validate your instructions and refine them until the agent's recommendations consistently match what you want.

Each time the agent accepts, rejects, or recommends a decision on an application, it leaves a note in the application's Activity log explaining why. See Track Recruitment Agent Results.

Rejections include a structured reject reason, so they flow correctly into your existing reports and the {rejectReason} email token.

Change a decision the agent made. If you need a different outcome for an application the agent accepted or rejected, select Review Decision on its row in the Processed tab of the Applications page. You can change a decision within 6 months of it being made. Correcting a rejection accepts the partner immediately, with no new invitation needed and no waiting on them to respond, so a wrong decision costs you no opportunity. See Change your decision on a processed application for both flows.

The Evaluate Applications sub-agent comes pre-configured. You can review and edit its safety guardrails, autonomy, and group assignment before you activate the agent. See Set up and activate the agent.

Invite Prospects (Coming Soon)

The Invite Prospects sub-agent appears in the agent’s configuration with a Coming Soon label. To email the prospects added by your Discover agent, use an Email Workflow:

  1. Set up a partner segment that targets the prospects Discover added. See Reach out to prospects added by the Recruitment Agent in Partner Segments for Email Workflows Explained.

  2. Create a custom email workflow that uses that segment, and add your outreach email. See Create & Manage Email Workflows.

  3. Optionally, send from your own email address instead of the generic impact.com address. See Connect Your Personal Email to Your impact.com Account. Once connected, your address appears as an option when you configure the workflow's email.

Protect your brand

The Recruitment Agent won't add the following partners to your program:

  • Partners on your blocklist.

  • Partners flagged for fraudulent behavior.

You can add another layer of protection by enabling Quality & Safety Guardrails on the Evaluate Applications sub-agent. See Set Up the Recruitment Agent.

See where the agent fits with your existing automation

If you already use Application Workflows, Impact AI, or an Application Webhook, the Recruitment Agent fits into a defined order so your existing automation continues to work as expected.

Applications are evaluated in this order:

  1. Platform safety checks. Basic safety checks run first.

  2. Impact AI.

  3. Application Workflows. Your rule-based automation.

  4. Recruitment Agent and your Application Webhook. The agent evaluates the applications the earlier steps left pending. At the same time, your Application Webhook sends the application to the endpoint you configure in event notification postbacks. The Webhook does not make a decision itself. You can post decisions back using the Application Processing API.

The Recruitment Agent never overrides a decision already made by the steps above. If a manual reviewer acts on an application before the agent finishes, the manual decision takes precedence.

If your instructions include hard, deterministic rules, such as "do not accept partners outside the US," consider adding those as Application Workflows too. Workflows are faster and do not consume agent capacity for decisions that do not need reasoning.

For more on workflow ordering, see Set Application Workflow Execution Order.

Manage your agents

The Agents page lists every agent you have activated. For Beta, you can set up 1 recruitment agent.

  1. From the left navigation menu, select [Agents].

    • Your agent appears as a card showing its status, last update, and quick actions.

  2. On your agent’s card, choose an action:

    • Select Edit to open the agent and adjust its settings.

    • Select Run Discover to start a Discovery run.

    • Hover over the card, then select [More] for more actions:

      • View Report: Open the Agent Overview, a summary of the agent's Discovery runs, application decisions, and performance. See Track Recruitment Agent Results.

      • View Prospects Found: Open the Prospects page, filtered to the prospects the Discover sub-agent added.

      • View Evaluated Applications: Open the Applications page, filtered to the applications the agent evaluated. See Track Recruitment Agent Results.

      • Pause: Stop scheduled Discovery runs and inbound application evaluation. Existing prospects and applications are unaffected.

      • Delete: Remove the agent.

To find your agent's results, see Track Recruitment Agent Results.

Update your agent's settings

You can adjust an active agent’s setup at any time. On the Agents page, select Edit on your agent’s card, then make any of these changes:

  • To rename the agent, select [Edit] next to the agent name at the top of the page.

  • To edit your instructions, select Edit in the Agent Instructions panel. See Write Effective Agent Instructions.

  • Select [Toggle on] or [Toggle off] on a sub-agent's card to include it in or pause it from the funnel. To change a sub-agent's settings, select Edit on its card. See Set Up the Recruitment Agent for what each setting does.

After you save your changes at the sub-agent level, select Update in the top-right corner to apply them.

Changes apply to future Discovery runs and future application evaluations. The agent does not reopen past decisions.

Follow best practices

  • Test before you commit. Validate your instructions with a small Discover run, and start the Evaluate Applications sub-agent in Copilot mode, before you scale up or switch to Autopilot. See Write Effective Agent Instructions.

  • Review partners when they become click-active. You can do this in 2 ways:

    • In the Partner Productivity Report, refer to Partner Name and First Click Date to see when a partner first drove a click after joining your program.

    • On the Applications screen, set the Processed By filter to Recruitment Agent to see every application the agent decisioned.

  • Reach out to newly added, click-active partners using Email Workflows to support their next steps as they join your program.

  • Expire contracts for partners that are not a good fit, then update your instructions to reduce similar mistakes in future evaluations.

Last updated

Was this helpful?