Tomba

Learn how to use Tomba with Composio

Overview

SLUG: TOMBA

Description

Tomba is an Email Finder for B2B sales and email marketing.

Authentication Details

generic_api_key
stringRequired
generic_secret
stringRequired

Connecting to Tomba

Create an auth config

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

1

Select App

Navigate to Tomba.

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 Tomba 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
4tomba_auth_config_id = "ac_YOUR_TOMBA_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 Tomba 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, tomba_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 Tomba toolkit’s playground

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=["TOMBA"])
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: List lead attributes

Description

Tool to list all lead attributes. use when you need to discover available attributes before enrichment.

Action Parameters

Action Response

data
arrayRequired
error
string
message
stringRequired
success
booleanRequired
successful
booleanRequired

Tool Name: Domain Status

Description

Tool to check if a domain is webmail or disposable. use when validating email deliverability constraints.

Action Parameters

domain
stringRequired

Action Response

data
objectRequired
error
string
status
booleanRequired
successful
booleanRequired

Tool Name: Delete API Key by ID

Description

Tool to delete an api key by id. use when you need to permanently revoke an api key before its expiration.

Action Parameters

key
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List API Keys

Description

Tool to list all api keys. use when you want to retrieve information about your existing tomba api keys.

Action Parameters

Action Response

data
objectRequired
error
string
message
string
meta
objectRequired
successful
booleanRequired

Tool Name: Create Lead

Description

Tool to add a new lead. use when you have lead details and need to save them to tomba.

Action Parameters

city
string
company
string
country
string
email
stringRequired
first_name
stringRequired
last_name
string
linkedin
string
phone
string
position
string
state
string
tags
array
twitter
string
website
string

Action Response

data
objectRequired
error
string
message
stringRequired
request_id
stringRequired
successful
booleanRequired

Tool Name: List Leads

Description

Tool to list all leads. use when you need to retrieve and paginate your leads list.

Action Parameters

limit
integer
page
integer
search
string
status
string

Action Response

data
arrayRequired
error
string
message
string
meta
objectRequired
successful
booleanRequired

Tool Name: Delete Leads List by ID

Description

Tool to delete a leads list by id. use when you need to permanently remove a list after confirming its id.

Action Parameters

id
stringRequired

Action Response

code
integerRequired
data
object
error
string
message
stringRequired
success
booleanRequired
successful
booleanRequired

Tool Name: List Lead Lists

Description

Tool to list all lead lists. use when you need to retrieve and paginate your lead lists.

Action Parameters

limit
integer
page
integer

Action Response

data
arrayRequired
error
string
meta
objectRequired
successful
booleanRequired

Tool Name: Update Leads List

Description

Tool to update a leads list's name by id. use when renaming an existing list after obtaining its id.

Action Parameters

id
stringRequired
name
string

Action Response

data
objectRequired
error
string
message
string
success
booleanRequired
successful
booleanRequired

Tool Name: Get Usage Statistics

Description

Tool to get api usage statistics. use when you need to monitor account usage and avoid hitting limits.

Action Parameters

Action Response

data
objectRequired
error
string
message
stringRequired
status
integerRequired
successful
booleanRequired