Benchmark Email

Learn how to use Benchmark Email with Composio

Overview

SLUG

BENCHMARK_EMAIL

Description

Benchmark Email is a comprehensive email marketing platform offering tools for creating, sending, and analyzing email campaigns.

Authentication Details

generic_api_key
stringRequired

Tools

SLUG: BENCHMARK_EMAIL_DELETE_CONTACT_FROM_LIST

Tool to delete a contact from a specific list by contactid. use when you have list and contact ids. example: "delete contact 2040826674 from list 15257899"

Action Parameters

contact_id
stringRequired
filter
string
list_id
stringRequired
search
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_DELETE_CONTACT_LIST

Tool to delete a contact list. use after confirming that the list is no longer in use.

Action Parameters

list_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_DELETE_EMAIL

Tool to delete an email campaign. use when removing a campaign by its id. use after confirming the campaign id is correct.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_DELETE_LINK_ACCOUNT

Tool to delete a linked agency account. use when revoking a linked agency account by its id. use after confirming the account id is correct.

Action Parameters

ID
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_DELETE_WEBHOOK

Tool to delete a webhook from a contact list by its id. use when removing obsolete or invalid webhooks after confirming list and webhook details.

Action Parameters

ID
integerRequired
ListID
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_ALL_CONFIRMED_EMAILS

Tool to retrieve all confirmed email addresses for the client account. use after user completes email confirmation flows to fetch final list.

Action Parameters

Action Response

count
integerRequired
data
arrayRequired
error
string
status
stringRequired
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_CLIENT_ACCOUNT_SETTINGS

Tool to get client account settings such as company, language, timezone, and sender info. use when you need to fetch account configuration before sending campaigns.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_CLIENT_DETAILS

Tool to get client details including profile data, contact count, and plan information. use when verifying account profile and limits.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_CLIENT_PLAN_INFORMATION

Tool to get client's plan information including addons, email plan, and total contacts. use when you need the current plan details before managing upgrades or billing.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_CLIENT_PROFILE_DETAILS

Tool to get client's profile details like business city, country, phone, and company. use after confirming authentication to fetch client profile info.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_CONTACTS_IN_LIST

Tool to fetch filtered and paginated contacts from a list by listid. use when narrowing a list via search, filters, and paging.

Action Parameters

Filter
string
ListID
stringRequired
OrderBy
string
PageNumber
integer
PageSize
integer
SearchField
string
SearchFilter
string
SearchType
string
SortOrder
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_CONTACT_LISTS

Tool to retrieve all contact lists. use when you need to list or select a contact list.

Action Parameters

exclude_email_id
string
filter
string
filter_type
string
order_by
string
page_number
integer
page_size
integer
sort_order
string
status
string

Action Response

count
integerRequired
data
arrayRequired
error
string
status
stringRequired
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_CONTACT_LIST_DETAILS

Tool to fetch detailed information for a contact list. use after confirming the list id to retrieve all metadata.

Action Parameters

list_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_EMAIL_REPORT_FORWARDS

Tool to get forwards report for an email campaign. use after campaign send to export its forwards.

Action Parameters

email_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_EMAIL_REPORT_UNOPENS

Tool to get unopens report for an email campaign by id. use when you need to export or review recipients who did not open a specific email campaign.

Action Parameters

email_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_LINK_ACCOUNT_DETAILS

Tool to get details of a linked agency account. use when retrieving info for a specific linked account by id after confirming the account exists.

Action Parameters

ID
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_LIST_LINK_ACCOUNTS

Tool to get list of linked agency accounts. use after linking agency accounts to retrieve all associated accounts.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_SUB_ACCOUNTS

Tool to retrieve all sub-accounts for the client. use when you need to view or manage sub-accounts.

Action Parameters

Action Response

Count
integerRequired
Data
arrayRequired
HasClientAccounts
stringRequired
HasDates
stringRequired
HasInbox
stringRequired
Status
stringRequired
UniqueCount
integerRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_SUB_ACCOUNTS_PLAN_LIST

Tool to retrieve available plans for a sub-account. use when you need to determine list and email limits for a specific sub-account client id.

Action Parameters

ID
stringRequired

Action Response

Data
arrayRequired
Status
stringRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_SUB_ACCOUNT_DETAILS

Tool to get details for a specific sub-account by id. use when needing profile and plan info of a child account.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_GET_SUB_ACCOUNT_HISTORY

Tool to get sub-account history. use after listing sub-accounts to retrieve each account's billing history.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_PATCH_CHANGE_PASSWORD

Tool to change the password for the client account. use when updating account credentials after validating new and confirm passwords match.

Action Parameters

ConfirmPassword
stringRequired
NewPassword
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_PATCH_SAVE_SECURITY_PIN

Tool to save a new security pin for the client account. use when you need to update the account pin after confirming both entries match.

Action Parameters

ConfirmNewPIN
stringRequired
NewPIN
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_PATCH_SEND_RESET_EMAIL

Tool to send a reset email link to change the primary email address. use when initiating an email-based reset of the account’s primary email after user request.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_PATCH_UPDATE_CLIENT_SETTINGS

Tool to update client account settings. use after fetching current settings. updates company info, timezone, language, sender defaults, and signature details.

Action Parameters

Detail
objectRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_PATCH_UPDATE_CONTACT_LIST

Tool to update an existing contact list. use after confirming list id and desired modifications to name, description, labels, or custom fields.

Action Parameters

Data
objectRequired
ListID
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_PATCH_UPDATE_EDIT_PROFILE

Tool to update or edit profile information such as first name, last name, and phone number. use after retrieving profile details to apply changes.

Action Parameters

FirstName
stringRequired
LastName
stringRequired
PhoneNo
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_PATCH_UPDATE_WEBHOOK

Tool to update a webhook for a contact list by webhook id. use after retrieving or creating a webhook to modify its event settings such as cleaned-address, email-change, profile-update, subscribe, and unsubscribe callbacks.

Action Parameters

Data
objectRequired
ID
integerRequired
ListID
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_POST_ADD_CONTACT_TO_LIST

Tool to add a new contact to a specific list. use after verifying the list id exists.

Action Parameters

Email
stringRequired
EmailPerm
string
FirstName
string
LastName
string
ListID
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_POST_CHANGE_SECURITY_PIN

Tool to change security pin for the client account. use after confirming your current pin to rotate your pin.

Action Parameters

ResetConfirmPIN
stringRequired
ResetOldPIN
stringRequired
ResetPIN
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_POST_CREATE_CONTACT_LIST

Tool to create a new contact list. use after planning list name and optional description.

Action Parameters

Description
string
Name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_POST_CREATE_WEBHOOK

Tool to create a new webhook for a contact list. use when you need to get callbacks for list events after list creation.

Action Parameters

CleanedAddress
stringRequired
ClientUrl
stringRequired
ContactMasterID
stringRequired
EmailChanged
stringRequired
ListID
stringRequired
ProfileUpdates
stringRequired
Subscribes
stringRequired
Unsubscribes
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_POST_DISABLE_SECURITY_PIN

Tool to disable security pin for the client account. use when revoking the current pin to remove pin protection.

Action Parameters

DisableOldPIN
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_POST_SAVE_WEBSITE_DOMAIN

Tool to save a website domain for your benchmark email account. use after account setup to register your domain for link tracking.

Action Parameters

CompanyWebsite
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_POST_SEND_CONFIRM_EMAIL_VERIFICATION

Tool to send confirm email verification. use when unverified addresses must receive verification emails after signup.

Action Parameters

EmailIDs
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BENCHMARK_EMAIL_POST_SEND_PIN_EMAIL

Tool to send pin via email. use when you forgot your security pin and need it emailed to you.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired