Email Verification

Neverbounce

Learn how to use Neverbounce with Composio

Overview

SLUG: NEVERBOUNCE

Description

NeverBounce provides email verification services to ensure the validity of email addresses, enhancing deliverability and reducing bounce rates.

Authentication Details

generic_api_key
stringRequired

Connecting to Neverbounce

Create an auth config

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

1

Select App

Navigate to Neverbounce.

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 Neverbounce 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
4neverbounce_auth_config_id = "ac_YOUR_NEVERBOUNCE_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 Neverbounce 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, neverbounce_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 Neverbounce 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=["NEVERBOUNCE"])
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: Get Account Info

Description

Tool to get account information including credits, job counts, and usage statistics. use when retrieving neverbounce account summary after authentication.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create NeverBounce Bulk Verification Job

Description

Tool to create a new bulk verification job with parsing, sampling, and callback options. use for asynchronous list verification with advanced control.

Action Parameters

auto_parse
boolean
auto_start
boolean
callback_headers
object
callback_url
filename
string
input
stringRequired
input_location
stringRequired
request_meta_data
object
run_sample
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete NeverBounce Job

Description

Tool to permanently delete a job and its results. use when you need to irreversibly remove a bulk verification job. this delete is irreversible.

Action Parameters

job_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Download Job Results (GET)

Description

Tool to download job results as a csv file via get. use after job completion to retrieve segmented or enriched csv output.

Action Parameters

addr
integer
alias
integer
bad_syntax
integer
binary_operators_type
string
catchalls
integer
disposables
integer
domain
integer
email_status
integer
email_status_int
integer
fqdn
integer
free_email_host
integer
has_dns_info
integer
has_mail_server
integer
host
integer
include_duplicates
integer
invalids
integer
job_id
integerRequired
line_feed_type
string
mail_server_reachable
integer
network
integer
only_bad_syntax
integer
only_duplicates
integer
role_account
integer
subdomain
integer
tld
integer
unknowns
integer
valids
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve Job Results

Description

Tool to retrieve paginated results for a completed job, including original data and verification outcomes. use after confirming job completion and when paging through results.

Action Parameters

items_per_page
integerDefaults to 10
job_id
integerRequired
page
integerDefaults to 1

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Start NeverBounce Job

Description

Tool to start a parsed job when auto start is disabled. use after creating a job with auto start=false.

Action Parameters

job_id
integerRequired
run_sample
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get bulk job status

Description

Tool to get the status and progress of a bulk verification job. use when

Action Parameters

job_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: NeverBounce Account Info

Description

Tool to get account information including credits, job counts, and usage statistics. use after authenticating to retrieve neverbounce account summary.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete NeverBounce Job

Description

Tool to permanently delete a job and its results. use when you need to irreversibly remove a bulk verification job. deletion is irreversible.

Action Parameters

job_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Download Job Results (POST)

Description

Tool to download job results as a csv file via post. use after job completion to fetch segmented or enriched csv output.

Action Parameters

alias
integer
bad_syntax
integer
binary_operators_type
string
catchalls
integer
disposables
integer
domain
integer
email_status
integer
email_status_int
integer
fqdn
integer
free_email_host
integer
has_dns_info
integer
has_mail_server
integer
host
integer
include_duplicates
integer
invalids
integer
job_id
integerRequired
line_feed_type
string
mail_server_reachable
integer
network
integer
only_bad_syntax
integer
only_duplicates
integer
role_account
integer
subdomain
integer
tld
integer
unknowns
integer
valids
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: NeverBounce Single Check

Description

Tool to verify a single email address and gather additional information. use when you need real-time validation at the point of entry.

Action Parameters

email
Required
request_meta_data
object
timeout
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: JS Widget Send Event

Description

Tool to send widget form events via the js widget api. use when reporting form.load or form.completion events after user interactions with your form.

Action Parameters

event
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired