---
ref: tool:instantly/import-supersearch-leads
name: Import leads from SuperSearch
company: company:instantly
workflows: []
access: [api]
tags: [capability:build-audience, category:sales-engagement, has:api]
docs: https://developer.instantly.ai/api-reference/supersearchenrichment/enrich-leads-from-supersearch
updated: 2026-09-27
---

# Import leads from SuperSearch

Adds the people matching a SuperSearch query to an Instantly lead list, creating the list if needed, and enriches them with work emails or LinkedIn profiles as you ask.

Pass `search_filters` (the same shape as the preview), a `limit`, and either
`resource_id` for an existing list or `list_name` for a new one. Turn on
`work_email_enrichment` for work emails and `fully_enriched_profile` for
LinkedIn profile data, and set `skip_rows_without_email` to drop people
without an email. Preview or count the matches first so the import brings in
the people you expect.

## Set up

Use the first option your agent supports.

### API (official)

- Base URL: https://api.instantly.ai
- Endpoint: `POST /api/v2/supersearch-enrichment/enrich-leads-from-supersearch`
- Auth: send the header `Authorization: Bearer $INSTANTLY_API_KEY`
- Get a key: https://app.instantly.ai/app/settings/integrations
- Docs: https://developer.instantly.ai/getting-started/authorization

Before doing anything else, make one read-only call to confirm access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.