The RocketReach connector lets your AI agent act in each user's RocketReach account. Each user connects their own RocketReach API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 16 tools.
- Tools
- 16
- What they doRead · write · destructive
- 13 · 3 · 013 read3 write0 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the RocketReach connection
In AgentKit > Connections, create a RocketReach connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'rocketreach'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize RocketReach:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'rocketreach_get_account',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "rocketreach"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize RocketReach:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="rocketreach_get_account",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their RocketReach credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolrocketreach_check_person_lookup_statusPoll the status of person lookups started with lookup_person or bulk_lookup_people.Read-onlyCheck Person Lookup Status
Poll the status of person lookups started with lookup_person or bulk_lookup_people. Returns one profile object per ID with status (complete, failed, waiting, searching or progress) and the contact details found so far. Use after a lookup whose status was not complete; webhooks avoid polling.
Inputs
idsarrayrequired- Profile IDs whose lookup status to check.
rocketreach_get_accountRetrieve the RocketReach account tied to the API key.Read-onlyGet Account
Retrieve the RocketReach account tied to the API key. Returns the user profile, credit usage per credit type, rate limits and API call counts. Use to check remaining lookup credits before running lookups.
Inputs
This tool takes no inputs.
rocketreach_get_universal_accountRetrieve the RocketReach account in Universal Credits mode.Read-onlyGet Universal Account
Retrieve the RocketReach account in Universal Credits mode. Returns the user profile, plan, API key details, daily API usage and the Universal Credits balance. Use instead of get_account when the account runs on Universal Credits.
Inputs
This tool takes no inputs.
rocketreach_lookup_companyLook up one company in RocketReach by domain, name, ID, LinkedIn URL or ticker.Read-onlyLookup Company
Look up one company in RocketReach by domain, name, ID, LinkedIn URL or ticker. Returns the company profile with domain, industry, size, revenue, location, links and tech stack where available. Use to enrich a known company; use search_companies to discover companies by criteria.
Inputs
domainstring- Web domain of the company; the preferred identifier.
idinteger- RocketReach company ID.
linkedin_urlstring- LinkedIn company page URL.
namestring- Company name to look up.
tickerstring- Stock ticker symbol of a public company.
rocketreach_lookup_personEnrich one person from RocketReach by profile ID, name and employer, LinkedIn URL, email, phone or NPI number.Read-onlyLookup Person
Enrich one person from RocketReach by profile ID, name and employer, LinkedIn URL, email, phone or NPI number. Returns the profile with title, employer, location, links and emails and phones. The status field is complete, progress, searching or not queued. Use to get contact details for one known person. Use check_person_lookup_status when the status is not complete, and search_people to discover people.
Inputs
current_employerstring- Current employer of the person. Must be sent together with name.
emailstring- Email address known for the person; used to find the matching profile.
idinteger- RocketReach profile ID of the person to look up. Use this when a search result already gave you the ID.
linkedin_urlstring- LinkedIn profile URL of the person, for example www.linkedin.com/in/jamesgullbrand.
lookup_typestring- Type of lookup to run. Defaults to the account default when omitted.one of
standardpremiumpremium (feeds disabled)bulkphoneenrich namestring- Full name of the person. Must be sent together with current_employer.
npi_numberinteger- National Provider Identifier of a US healthcare professional.
phonestring- Phone number known for the person, in E.164 or international format.
return_cached_emailsboolean- When false, email fields stay null until the lookup finishes and all emails are verified. When true or omitted, cached emails are returned immediately even while the status is progress.
titlestring- Job title of the person; improves match accuracy when searching by name and employer.
webhook_idinteger- ID of a webhook configured in your RocketReach API settings; the finished lookup result is posted to it.
rocketreach_lookup_person_and_companyEnrich one person and compile the full profile of their current employer in one call.Read-onlyLookup Person and Company
Enrich one person and compile the full profile of their current employer in one call. Returns the person profile plus a compiled company object with firmographic details. Use when you need both person and company data; use lookup_person when only the person is needed.
Inputs
current_employerstring- Current employer of the person. Must be sent together with name.
emailstring- Email address known for the person; used to find the matching profile.
idinteger- RocketReach profile ID of the person to look up. Use this when a search result already gave you the ID.
linkedin_urlstring- LinkedIn profile URL of the person, for example www.linkedin.com/in/jamesgullbrand.
lookup_typestring- Type of lookup to run. Defaults to the account default when omitted.one of
standardpremiumpremium (feeds disabled)bulkphoneenrich namestring- Full name of the person. Must be sent together with current_employer.
npi_numberinteger- National Provider Identifier of a US healthcare professional.
phonestring- Phone number known for the person, in E.164 or international format.
return_cached_emailsboolean- When false, email fields stay null until the lookup finishes and all emails are verified. When true or omitted, cached emails are returned immediately even while the status is progress.
titlestring- Job title of the person; improves match accuracy when searching by name and employer.
webhook_idinteger- ID of a webhook configured in your RocketReach API settings; the finished lookup result is posted to it.
rocketreach_search_companiesSearch RocketReach for companies matching criteria such as industry, size, revenue, location and tech stack.Read-onlySearch Companies
Search RocketReach for companies matching criteria such as industry, size, revenue, location and tech stack. Returns a page of matching companies plus pagination details. Use to discover companies; use lookup_company for one known company.
Inputs
queryobjectrequired- Search criteria as a JSON object. Each key is a filter and each value is an array of strings, for example {"industry": ["Computer Software"], "employees": ["51-200"], "geo": ["United States"], "techstack": ["Salesforce"]}. Commonly used filters are name, domain, industry, employees, revenue, total_funding, geo, location, keyword, techstack and publicly_traded. Different filters are combined.
order_bystring- Result ordering. relevance is the default; popularity matches the RocketReach web app ordering.
page_sizeinteger- Maximum number of results to return per page, from 1 to 100.default
10 startinteger- 1-based index of the first result to return; use it to page through results.default
1
rocketreach_search_peopleSearch RocketReach for people matching criteria such as title, employer, location, department and skills.Read-onlySearch People
Search RocketReach for people matching criteria such as title, employer, location, department and skills. Returns a page of matching profiles (id, name, title, employer, location) plus pagination details; contact details are not unlocked. Use to discover people; use lookup_person with a returned profile ID to get emails and phones.
Inputs
queryobjectrequired- Search criteria as a JSON object. Each key is a filter and each value is an array of strings, for example {"current_title": ["VP of Sales"], "company_name": ["RocketReach"], "geo": ["United States"]}. Commonly used filters are name, current_title, current_employer or employer, company_name, company_domain, company_size, company_industry, department, management_levels, geo, skills, school, email_grade and contact_method. Multiple values within one filter match any of them, and different filters are combined. Wrap a value in double quotes for an exact match and prefix it with - to exclude it.
order_bystring- Result ordering. relevance is the default; popularity matches the RocketReach web app ordering.
page_sizeinteger- Maximum number of results to return per page, from 1 to 100.default
10 startinteger- 1-based index of the first result to return; use it to page through results.default
1
rocketreach_universal_check_person_lookup_statusPoll the status of Universal Credits person lookups.Read-onlyUniversal Check Person Lookup Status
Poll the status of Universal Credits person lookups. Returns one profile object per ID with status and the data revealed so far. Use after universal_lookup_person or universal_bulk_lookup_people returns a status other than complete.
Inputs
idsarrayrequired- Profile IDs whose lookup status to check.
rocketreach_universal_lookup_companyLook up one company in RocketReach using Universal Credits, by domain, name, ID, LinkedIn URL or ticker.Read-onlyUniversal Lookup Company
Look up one company in RocketReach using Universal Credits, by domain, name, ID, LinkedIn URL or ticker. Returns the company profile with domain, industry, size, revenue, location and links. Use on Universal Credits accounts; use lookup_company on standard credit accounts.
Inputs
domainstring- Web domain of the company; the preferred identifier.
idinteger- RocketReach company ID.
linkedin_urlstring- LinkedIn company page URL.
namestring- Company name to look up.
tickerstring- Stock ticker symbol of a public company.
rocketreach_universal_lookup_personEnrich one person using Universal Credits, choosing which data to reveal.Read-onlyUniversal Lookup Person
Enrich one person using Universal Credits, choosing which data to reveal. Returns the profile with only the revealed contact data (phones, professional emails, personal emails, detailed or healthcare enrichment). The status field is complete, progress, searching or not queued. Use on Universal Credits accounts; use lookup_person on standard credit accounts. Poll universal_check_person_lookup_status when not complete.
Inputs
current_employerstring- Current employer of the person. Must be sent together with name.
emailstring- Email address known for the person; used to find the matching profile.
idinteger- RocketReach profile ID of the person to look up. Use this when a search result already gave you the ID.
linkedin_urlstring- LinkedIn profile URL of the person, for example www.linkedin.com/in/jamesgullbrand.
namestring- Full name of the person. Must be sent together with current_employer.
npi_numberinteger- National Provider Identifier of a US healthcare professional.
phonestring- Phone number known for the person, in E.164 or international format.
return_cached_emailsboolean- When false, email fields stay null until the lookup finishes and all emails are verified. When true or omitted, cached emails are returned immediately even while the status is progress.
reveal_detailed_person_enrichmentboolean- Set to true to reveal detailed person enrichment data for this profile, which spends Universal Credits.
reveal_healthcare_enrichmentboolean- Set to true to reveal healthcare enrichment data for this profile, which spends Universal Credits.
reveal_personal_emailboolean- Set to true to reveal personal emails for this profile, which spends Universal Credits.
reveal_phoneboolean- Set to true to reveal phone numbers for this profile, which spends Universal Credits.
reveal_professional_emailboolean- Set to true to reveal professional emails for this profile, which spends Universal Credits.
titlestring- Job title of the person; improves match accuracy when searching by name and employer.
webhook_idinteger- ID of a webhook configured in your RocketReach API settings; the finished lookup result is posted to it.
rocketreach_universal_search_companiesSearch RocketReach companies using Universal Credits.Read-onlyUniversal Search Companies
Search RocketReach companies using Universal Credits. Returns a page of matching companies plus pagination details. Use on Universal Credits accounts; use search_companies on standard credit accounts.
Inputs
queryobjectrequired- Search criteria as a JSON object. Each key is a filter and each value is an array of strings, for example {"industry": ["Computer Software"], "employees": ["51-200"], "geo": ["United States"], "techstack": ["Salesforce"]}. Commonly used filters are name, domain, industry, employees, revenue, total_funding, geo, location, keyword, techstack and publicly_traded. Different filters are combined.
order_bystring- Result ordering. relevance is the default; popularity matches the RocketReach web app ordering.
page_sizeinteger- Maximum number of results to return per page, from 1 to 100.default
100 startinteger- 1-based index of the first result to return; use it to page through results.default
1
rocketreach_universal_search_peopleSearch RocketReach people using Universal Credits.Read-onlyUniversal Search People
Search RocketReach people using Universal Credits. Returns a page of matching profiles plus pagination details. Use on Universal Credits accounts; use search_people on standard credit accounts.
Inputs
queryobjectrequired- Search criteria as a JSON object. Each key is a filter and each value is an array of strings, for example {"current_title": ["VP of Sales"], "company_name": ["RocketReach"], "geo": ["United States"]}. Commonly used filters are name, current_title, current_employer or employer, company_name, company_domain, company_size, company_industry, department, management_levels, geo, skills, school, email_grade and contact_method. Multiple values within one filter match any of them, and different filters are combined. Wrap a value in double quotes for an exact match and prefix it with - to exclude it.
order_bystring- Result ordering. relevance is the default; popularity matches the RocketReach web app ordering.
page_sizeinteger- Maximum number of results to return per page, from 1 to 100.default
100 startinteger- 1-based index of the first result to return; use it to page through results.default
1
rocketreach_bulk_lookup_peopleStart asynchronous lookups for up to 100 people in one request.WriteBulk Lookup People
Start asynchronous lookups for up to 100 people in one request. Returns acknowledgement with the profile IDs queued; results arrive by webhook or by polling check_person_lookup_status. Use for batches; use lookup_person for a single person. Spends lookup credits.
Inputs
queriesarrayrequired- List of lookup criteria objects, at most 100. Each object identifies one person with id, name together with current_employer, linkedin_url, email, phone or npi_number, and optionally title.
profile_liststring- Name of the profile list that looked-up profiles are added to when the lookup completes.default
API Bulk Lookup webhook_idinteger- ID of a webhook from your RocketReach API settings that receives the results when the lookups complete.
rocketreach_universal_bulk_lookup_peopleStart asynchronous Universal Credits lookups for up to 100 people.WriteUniversal Bulk Lookup People
Start asynchronous Universal Credits lookups for up to 100 people. Returns acknowledgement with the profile IDs queued; results arrive by webhook or by polling universal_check_person_lookup_status. Use for batches on Universal Credits accounts. Spends Universal Credits for every revealed field.
Inputs
queriesarrayrequired- List of lookup criteria objects, at most 100. Each object identifies one person with id, name together with current_employer, linkedin_url, email, phone or npi_number, and may set reveal_phone, reveal_professional_email, reveal_personal_email, reveal_detailed_person_enrichment and reveal_healthcare_enrichment to true to unlock that data.
profile_liststring- Name of the profile list that looked-up profiles are added to when the lookup completes.default
API Bulk Lookup webhook_idinteger- ID of a webhook from your RocketReach API settings that receives the results when the lookups complete.
rocketreach_verify_emailVerify whether an email address can receive mail.WriteVerify Email
Verify whether an email address can receive mail. Returns the canonical email, a status (valid, invalid, catchall or unknown), credits charged, the MX host and the individual check results. Use before sending outreach to a found address. Spends one email verification credit, refunded when the status is unknown or the format is invalid.
Inputs
emailstringrequired- Email address to verify, at most 254 characters.
No tools match.
