# Tomba

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

- **Category:** sales & crm
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `TOMBA`
- **Version:** 20260211_00

## Tools

### List Lead Attributes

**Slug:** `TOMBA_ATTRIBUTES_LIST`

Retrieves all custom lead attributes defined in your Tomba account. Use this action to discover the available attributes that can be used when creating or updating leads. Returns attribute metadata including name, identifier, type, and timestamps. No input parameters required.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Domain Status

**Slug:** `TOMBA_DOMAIN_STATUS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | The domain name to check the status for (e.g., 'gmail.com') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete API Key by ID

**Slug:** `TOMBA_KEYS_DELETE`

Tool to delete an API key by its numeric ID. Use when you need to permanently revoke an API key before its expiration. Note: You can get the numeric key ID from the TOMBA_KEYS_LIST action.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key_id` | string | Yes | The numeric ID of the API key to delete. This is the 'id' field returned by the keys list endpoint, not the key string itself. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List API Keys

**Slug:** `TOMBA_KEYS_LIST`

Tool to list all API keys. Use when you want to retrieve information about your existing Tomba API keys.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Lead

**Slug:** `TOMBA_LEADS_CREATE`

Create a new lead in Tomba's lead database. Use this to store contact information for a person you want to track. Returns the unique ID of the created lead. Required fields: first_name, email. All other fields are optional.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | No | City where the lead is located |
| `tags` | array | No | List of tags to categorize or label the lead for organization |
| `email` | string | Yes | Lead's email address (required). Must be a valid email format |
| `phone` | string | No | Lead's phone number, including country code if international |
| `state` | string | No | State or province where the lead is located |
| `company` | string | No | Company or organization the lead works for |
| `country` | string | No | Two-letter ISO 3166-1 alpha-2 country code. Must use the code format, not full country name |
| `twitter` | string | No | Full Twitter/X profile URL |
| `website` | string | No | Lead's personal or company website URL |
| `linkedin` | string | No | Full LinkedIn profile URL |
| `position` | string | No | Lead's job title or position |
| `last_name` | string | No | Lead's last name. If provided, must not be empty |
| `first_name` | string | Yes | Lead's first name (required) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Leads

**Slug:** `TOMBA_LEADS_LIST`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (1-indexed). Defaults to 1 if not specified. |
| `limit` | integer | No | Number of leads per page (1-100). Defaults to 10 if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Leads List by ID

**Slug:** `TOMBA_LISTS_DELETE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique numeric identifier of the leads list to delete. Obtain this ID from the lists list action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Lead Lists

**Slug:** `TOMBA_LISTS_LIST`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be >= 1 |
| `limit` | integer | No | Number of items per page, between 1 and 100 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Leads List

**Slug:** `TOMBA_LISTS_UPDATE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Numeric ID of the leads list to update (obtain from TOMBA_LISTS_LIST action) |
| `name` | string | Yes | New name for the leads list. Must be unique across all lists in the account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Usage Statistics

**Slug:** `TOMBA_USAGE_STATS`

Tool to get API usage statistics. Use when you need to monitor account usage and avoid hitting limits.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |