Crm

Rocket reach

Learn how to use Rocket reach with Composio

Overview

SLUG: ROCKET_REACH

Description

RocketReach locates and verifies professional contact details, helping sales and recruiters reach leads and candidates more efficiently

Authentication Details

generic_api_key
stringRequired

Connecting to Rocket reach

Create an auth config

Use the dashboard to create an auth config for the Rocket reach toolkit. This allows you to connect multiple Rocket reach accounts to Composio for agents to use.

1

Select App

Navigate to [Rocket reach](https://platform.composio.dev?next_page=/marketplace/Rocket reach).

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Rocket reach Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4rocket_reach_auth_config_id = "ac_YOUR_ROCKET_REACH_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Rocket reach for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, rocket_reach_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [Rocket reach toolkit’s playground](https://app.composio.dev/app/Rocket reach)

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["ROCKET_REACH"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Check Person Status

Description

Tool to check the status of multiple person lookup requests. Use when you need to retrieve the current status of previously initiated person lookups.

Action Parameters

ids
arrayRequired

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get RocketReach Account Info

Description

Tool to retrieve account information for the authenticated user. Use when you need to fetch the current user's account details.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: RocketReach Get Company Funding

Description

Tool to retrieve funding details for a specified company. Use when you need to fetch historical funding rounds by company domain.

Action Parameters

domain
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Company Growth Metrics

Description

Tool to get growth metrics for a specified company domain. Use when historical company growth data is needed after confirming the exact company domain.

Action Parameters

domain
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Company Industries

Description

Tool to list industries associated with a specified company. Tries multiple RocketReach endpoints using the provided identifier (ID, domain, or name) and extracts industry information from the response payload.

Action Parameters

company_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Company Size

Description

Tool to retrieve size metrics of a company. Use when you have a company's domain to get its employee size range.

Action Parameters

domain
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Company Tech Stack

Description

Tool to get technology stack for a company by domain. Use when you need to discover the tech a company uses after confirming its domain.

Action Parameters

domain
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: RocketReach Lookup Company

Description

Tool to lookup a company's domain via RocketReach Company Lookup API. Use when you need the company domain by name for downstream actions like funding, size, or tech stack.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: RocketReach Lookup Person

Description

Tool to lookup detailed person information from RocketReach. Use when you need to fetch a person's profile by email.

Action Parameters

email
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Companies

Description

Tool to list companies by name or keyword. Use when you need to discover companies matching specific criteria after obtaining an API key.

Action Parameters

limit
integerDefaults to 20
page
integerDefaults to 1
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Search People

Description

Tool to search for people by name, title, or keywords. Use when you need to discover individuals matching specific criteria after obtaining an API key.

Action Parameters

limit
integerDefaults to 20
page
integerDefaults to 1
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired