CONNECT APP
Build with Tomba
Tomba is the leading solution to find and verify professional email addresses. Start using Tomba and connect with the people that matter for your business.
CRM
- API key
MCP
Give your agent Tomba tools
Every Tomba action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's Tomba account for each tool call — you store no tokens.
// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "tomba",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// e.g. run Enrich Email:
const result = await mcp.callTool({
name: "tomba-enrich-email",
arguments: {
email: "Email Address",
},
})# access_token: mint a short-lived token with the Connect SDK — see the MCP guide
headers = {
"Authorization": f"Bearer {access_token}",
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", # any stable ID for this user in your system
"x-pd-app-slug": "tomba",
}
async with streamablehttp_client("https://remote.mcp.pipedream.net/v3", headers=headers) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
# e.g. run Enrich Email:
result = await session.call_tool("tomba-enrich-email", {
"email": "Email Address",
})API PROXY
Call the Tomba API directly
For an endpoint with no pre-built tool, the Connect proxy forwards your request to the Tomba API with the connected user's credentials attached. You store no tokens and write no refresh logic.
const resp = await pd.proxy.get({
externalUserId: "{external_user_id}", // any stable ID for this user in your system
accountId: "apn_xxxxxxx",
url: "https://api.tomba.io/v1/me",
})
// Any allowed Tomba endpoint works here. Pipedream attaches the
// connected account's credentials to the outgoing request.# The path segment is the target URL, URL-safe base64 encoded:
# https://api.tomba.io/v1/me
curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkudG9tYmEuaW8vdjEvbWU?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
-H "Authorization: Bearer {access_token}" \
-H "x-pd-environment: production"SDK
Run Tomba actions from your backend
Connect a user's Tomba account once, then run Enrich Email on their behalf from your own code — TypeScript, Python, or plain HTTP.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "tomba-enrich-email",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
tomba: { authProvisionId: "apn_xxxxxxx" },
email: "Email Address",
},
})from pipedream import Pipedream
pd = Pipedream(
client_id="{oauth_client_id}",
client_secret="{oauth_client_secret}",
project_id="{project_id}",
project_environment="production",
)
result = pd.actions.run(
id="tomba-enrich-email",
external_user_id="{external_user_id}", # any stable ID for this user in your system
configured_props={
"tomba": {"authProvisionId": "apn_xxxxxxx"},
"email": "Email Address",
},
)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "tomba-enrich-email",
"configured_props": {
"tomba": { "authProvisionId": "apn_xxxxxxx" },
"email": "Email Address"
}
}'TOOLS
Tomba actions
On-demand operations your product or agent can configure and run on behalf of a connected user.
-
Enrich Email
actionLook up person and company data based on an email. See the documentationRead-onlyv0.0.1 -
Find Author
actionGenerate or retrieve the most likely email address from a blog post URL. See the documentationRead-onlyv0.0.1 -
Find Email
actionGenerate or retrieve the most likely email address from a domain name, a first name and a last name. See the documentationRead-onlyv0.0.1 -
Find LinkedIn Email
actionGenerate or retrieve the most likely email address from a LinkedIn URL. See the documentationRead-onlyv0.0.1 -
Find Phone
actionSearch for phone numbers based on an email, domain, or LinkedIn URL. See the documentationRead-onlyv0.0.1 -
Find Similar Domains
actionRetrieve similar domains based on a specific domain. See the documentationRead-onlyv0.0.1 -
Get Account
actionReturns information about the current account including usage statistics and plan details. See the documentationRead-onlyv0.0.1 -
Get Domain Status
actionFind domain status if is webmail or disposable. See the documentationRead-onlyv0.0.1 -
Get Domain Suggestions
actionRetrieve a list of suggested domains similar to or related to your search query. This helps discover competitors, similar companies, and related businesses for market research and prospecting. See the documentationRead-onlyv0.0.1 -
Get Email Count
actionFind total email addresses we have for one domain. See the documentationRead-onlyv0.0.1 -
Get Email Format
actionRetrieve the email format patterns used by a specific domain. See the documentationRead-onlyv0.0.1 -
Get Email Sources
actionFind email address source somewhere on the web. See the documentationRead-onlyv0.0.1 -
Get Location
actionGet employees location based on the domain name. See the documentationRead-onlyv0.0.1 -
Get Logs
actionRetrieve API request logs for your account with pagination support. See the documentationRead-onlyv0.0.1 -
Get Technology
actionRetrieve the technologies used by a specific domain. See the documentationRead-onlyv0.0.1 -
Get Usage
actionRetrieve API usage statistics and quota information for your account. See the documentationRead-onlyv0.0.1 -
Search Companies
actionSearch for companies using natural language queries or structured filters. The AI assistant will automatically generate appropriate filters from your query. See the documentationRead-onlyv0.0.2 -
Search Domain
actionGet every email address found on the internet using a given domain name, with sources. See the documentationRead-onlyv0.0.1 -
Validate Phone
actionValidate a phone number and retrieve its associated information. See the documentationRead-onlyv0.0.1 -
Verify Email
actionVerify the deliverability of an email address. See the documentationRead-onlyv0.0.1
No Tomba triggers are available yet.
- App slug
- tomba
- Authentication
- API key
- Categories
- CRM
- Actions
- 20
- Triggers
- 0
- API proxy
- Available