NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Tomba connects to a Nagent workspace with an API key. Once it is connected, agents can call 10 Tomba actions, such as "List Lead Attributes", "List API Keys" and "Create Lead". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Tomba, with input parameters and output schema.
TOMBA_ATTRIBUTES_LISTRetrieves 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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TOMBA_DOMAIN_STATUSTool to check if a domain is webmail or disposable. Use when validating email deliverability constraints.
Input parameters
The domain name to check the status for (e.g., 'gmail.com')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TOMBA_KEYS_DELETETool 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
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TOMBA_KEYS_LISTTool to list all API keys. Use when you want to retrieve information about your existing Tomba API keys.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TOMBA_LEADS_CREATECreate 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
City where the lead is located
List of tags to categorize or label the lead for organization
Lead's email address (required). Must be a valid email format
Lead's phone number, including country code if international
State or province where the lead is located
Company or organization the lead works for
Two-letter ISO 3166-1 alpha-2 country code. Must use the code format, not full country name
Full Twitter/X profile URL
Lead's personal or company website URL
Full LinkedIn profile URL
Lead's job title or position
Lead's last name. If provided, must not be empty
Lead's first name (required)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TOMBA_LEADS_LISTTool to list all leads. Use when you need to retrieve and paginate your leads list.
Input parameters
Page number to retrieve (1-indexed). Defaults to 1 if not specified.
Number of leads per page (1-100). Defaults to 10 if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TOMBA_LISTS_DELETETool to delete a leads list by ID. Use when you need to permanently remove a list after confirming its ID.
Input parameters
The unique numeric identifier of the leads list to delete. Obtain this ID from the lists list action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TOMBA_LISTS_LISTTool to list all lead lists. Use when you need to retrieve and paginate your lead lists.
Input parameters
Page number for pagination, must be >= 1
Number of items per page, between 1 and 100
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TOMBA_LISTS_UPDATETool to update a leads list's name by ID. Use when renaming an existing list after obtaining its ID.
Input parameters
Numeric ID of the leads list to update (obtain from TOMBA_LISTS_LIST action)
New name for the leads list. Must be unique across all lists in the account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TOMBA_USAGE_STATSTool to get API usage statistics. Use when you need to monitor account usage and avoid hitting limits.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 10 Tomba actions on Nagent, including "List Lead Attributes", "List API Keys" and "Create Lead". List Lead Attributes: Retrieves all custom lead attributes defined in your Tomba account. Each action is listed on this page with its input parameters and its output.
Tomba connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It returns data, error and successful.