ClickSend is a cloud-based SMS and email marketing platform that enables businesses to send and receive SMS messages, manage contacts, and track campaign performance.
ClickSend is a cloud-based SMS and email marketing platform that enables businesses to send and receive SMS messages, manage contacts, and track campaign performance. On Nagent, ClickSend is exposed as a fully-configurable phone & sms integration that any agent can call — 166 actions, and BASIC authentication. No code is required to wire ClickSend into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use ClickSend to automate the kinds of tasks phone & sms teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire ClickSend into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against ClickSend, with input parameters and output schema. Drop these into any step of an agent built in Helix.
CLICKSEND_ACCOUNT_USEAGE_BY_SUBACCOUNT_GETRetrieve detailed account usage statistics grouped by subaccount for a specific month and year. Returns usage data for all message types (SMS, MMS, voice, fax, email, post, postcards) broken down by individual subaccounts, along with totals and currency information. Use when you need to view usage breakdown across subaccounts for billing, cost allocation, or monitoring purposes.
Input parameters
Year to filter usage by in four-digit format (yyyy)
Month to filter usage by in numeric format (1-12)
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
CLICKSEND_ACCOUNT_VERIFY_SEND_PUTTool to send an account activation token for verification. Use when you need to verify a new user account via SMS or other verification method.
Input parameters
Verification method type. Required for successful verification.
Country designation (e.g., 'US'). Required for successful verification.
Your phone number in E.164 format (e.g., '+13523944199'). Required for successful verification.
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
CLICKSEND_ACCOUNT_VERIFY_VERIFY_BY_ACTIVATION_TOKEN_PUTTool to verify a new ClickSend account using an activation token. Use when you need to activate a newly created account with the token received during registration.
Input parameters
Activation token for account verification (integer format)
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
CLICKSEND_CALCULATE_POST_LETTERS_PRICECalculate the price for sending physical post letters via ClickSend without actually sending them. This tool estimates the cost of postal letters based on the file, recipients, and printing options (priority, color, duplex). It returns detailed pricing information including per-recipient costs, total price, and currency details. Use this when you need to: - Get a cost estimate before sending postal letters - Calculate bulk pricing for multiple recipients - Compare costs with different printing options (color vs B&W, single vs double-sided, standard vs priority) Note: You must have a valid return_address_id for each recipient. Use the "Get All Post Return Addresses" or "Create Post Return Address" actions to obtain return address IDs.
Input parameters
Whether letter is printed in colour. 0 = black and white, 1 = colour. Default is 0.
Whether letter is printed double-sided. 0 = single-sided, 1 = double-sided. Default is 0.
Source identifier for tracking purposes. Can be any string value.
URL of the PDF file to calculate price for. For docx/doc files, convert them first using the /uploads?convert=post endpoint. Supported formats: pdf, docx, doc, jpg, gif, png, bmp.
Array of recipient objects. Each recipient represents a person who will receive a copy of the letter.
Whether the letter is priority post. 0 = standard post, 1 = priority post. Default is 0.
Whether using a ClickSend template. 0 = not using template, 1 = using template. Default is 0.
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
CLICKSEND_CALCULATE_SMS_CAMPAIGNS_PRICETool to calculate the price for an SMS campaign before sending. Use when you need to estimate costs for an SMS campaign to a contact list. Pricing depends on the number of recipients, message length, and destination countries.
Input parameters
Your campaign message content. Use placeholders like (First Name) for personalization. Required field.
Sender identifier (phone number or alphanumeric sender ID). See ClickSend docs for supported formats. Optional field.
Your campaign name for identification. Required field.
Your contact list ID containing the campaign recipients. Required field.
Unix timestamp for scheduling the campaign. Defaults to 0 for immediate sending. Optional field.
URL to shorten in the campaign. IMPORTANT: When using this parameter, you MUST include the placeholder 'http://smsg.io/xxxxx' in your message body where the shortened link should appear. The API will reject requests with url_to_shorten if the placeholder is missing from the body. Optional field.
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
CLICKSEND_CREATE_AUTOMATIONS_EMAIL_RECEIPTSTool to create an email delivery receipt automation rule in ClickSend. Use when you need to set up automated actions to trigger when email delivery receipts are received.
Input parameters
Determines the response type when rule matches. Currently only 'URL' is supported for email delivery receipt automations. When using 'URL', specify a valid HTTP/HTTPS endpoint in action_address.
Controls activation status of the rule. Use 1 to enable the rule immediately, or 0 to create it in a disabled state.
Name to identify the automation rule. Helps organize and manage multiple rules.
Specifies match criteria for the delivery receipt. Use 0 to match all email delivery reports.
The URL endpoint where delivery receipt data should be posted. Must be a valid HTTP or HTTPS URL. Required when action is 'URL'.
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
CLICKSEND_CREATE_AUTOMATIONS_FAX_INBOUNDTool to create a new inbound fax automation rule in ClickSend. Use when you need to set up automated actions to trigger when inbound faxes are received.
Input parameters
The action to perform when a fax is received. Supported actions: EMAIL_FIXED (send to fixed email), URL (send to webhook), POLL (retrieve via API polling), EMAIL_USER (send to user's email), SMS (send SMS notification), AUTO_REPLY, GROUP_SMS, MOVE_CONTACT, CREATE_CONTACT, CREATE_CONTACT_PLUS_EMAIL, CREATE_CONTACT_PLUS_NAME_EMAIL, CREATE_CONTACT_PLUS_NAME, SMPP, NONE.
Controls activation status of the rule. 0 = disabled, 1 = enabled.
Name of the automation rule to identify it. Helps organize and manage multiple rules.
The destination address for the action. For EMAIL_FIXED/EMAIL_USER, provide an email address. For URL/POLL, provide a webhook URL. For SMS, provide a phone number.
The dedicated fax number to apply this rule to. Use '*' to apply the rule to all fax numbers.
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
CLICKSEND_CREATE_AUTOMATIONS_FAX_RECEIPTSCreates a fax delivery receipt automation rule in ClickSend. When faxes are delivered, this rule automatically triggers the specified action (e.g., sends receipt data to a webhook URL, forwards to an email, or sends an SMS). Use this to integrate fax delivery tracking into your systems or workflow.
Input parameters
Action to perform when a fax delivery receipt is received. Common values: 'URL' (webhook), 'EMAIL_FIXED' (send to specific email), 'EMAIL_USER' (send to account email), 'SMS', 'POLL'. Other options: AUTO_REPLY, GROUP_SMS, MOVE_CONTACT, CREATE_CONTACT, CREATE_CONTACT_PLUS_EMAIL, CREATE_CONTACT_PLUS_NAME_EMAIL, CREATE_CONTACT_PLUS_NAME, SMPP, NONE.
Rule activation status. 1 = rule is active and will trigger, 0 = rule is disabled. Default: 1
Descriptive name for the automation rule. Used to identify and organize rules in your account.
Match criteria type for fax receipts. Currently only 0 (match all fax delivery receipts) is supported. Default: 0
Destination for the action. For 'URL': webhook endpoint URL. For 'EMAIL_FIXED'/'EMAIL_USER': email address. For 'SMS': phone number. Must match the action type.
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
CLICKSEND_CREATE_AUTOMATIONS_SMS_INBOUNDTool to create a new inbound SMS automation rule in ClickSend. Use when you need to set up automated actions to trigger when inbound SMS messages are received.
Input parameters
Action to perform when rule matches. Valid values: AUTO_REPLY, EMAIL_USER, EMAIL_FIXED, URL, SMS, POLL, GROUP_SMS, MOVE_CONTACT, CREATE_CONTACT, CREATE_CONTACT_PLUS_EMAIL, CREATE_CONTACT_PLUS_NAME_EMAIL, CREATE_CONTACT_PLUS_NAME, SMPP, NONE.
Controls activation status of the rule. 0 = disabled, 1 = enabled.
Name of the automation rule to identify it. Helps organize and manage multiple rules.
Webhook format type. Valid values: 'post', 'get', or 'json'. Defaults to 'post' if not specified.
Target destination for the specified action. For EMAIL_FIXED provide email address, for URL provide webhook URL, for contact lists provide list ID.
The dedicated phone number to apply this rule to. Use '*' to apply the rule to all numbers.
Text pattern to match against incoming messages. Can be null for message_search_type=0 (any message).
Message matching logic. 0 = Any message, 1 = starts with, 2 = contains, 3 = does not contain.
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
CLICKSEND_CREATE_AUTOMATIONS_SMS_RECEIPTSTool to create an SMS delivery receipt automation rule in ClickSend. Use when you need to set up automated actions to trigger when SMS delivery receipts are received.
Input parameters
Determines the response type when rule matches. Valid values: AUTO_REPLY, EMAIL_USER, EMAIL_FIXED, URL, SMS, POLL, GROUP_SMS, MOVE_CONTACT, CREATE_CONTACT, CREATE_CONTACT_PLUS_EMAIL, CREATE_CONTACT_PLUS_NAME_EMAIL, CREATE_CONTACT_PLUS_NAME, SMPP, or NONE.
Controls activation status of the rule. 0 = disabled, 1 = enabled.
Name to identify the automation rule. Helps organize and manage multiple rules.
Specifies match criteria for the delivery receipt. Valid values: 0 (match all reports), 1, or 2. Values must be between 0 and 2.
Specifies where the action should be directed (e.g., email address for EMAIL_FIXED action, URL for URL 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
CLICKSEND_CREATE_AUTOMATIONS_VOICE_RECEIPTSTool to create a voice delivery receipt automation rule in ClickSend. Use when you need to set up automated actions to forward voice delivery receipts to a specified URL or email when voice messages are delivered.
Input parameters
Response action to perform when rule matches (e.g., 'URL' for webhook, 'EMAIL_FIXED' for email notification).
Binary flag to activate/deactivate the rule. 1 = enabled, 0 = disabled.
Name identifying the automation rule. Helps organize and manage multiple rules.
Determines which delivery statuses trigger the rule. Valid values: 0 = All delivery reports, 1 = Specific status filter, 2 = Specific status filter. Must be between 0 and 2.
Target destination for the action - URL endpoint or email address where delivery receipts will be sent.
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
CLICKSEND_CREATE_DELIVERY_ISSUESTool to create a delivery issue report in ClickSend. Use when you need to report problems with message delivery such as messages not being received or delivery failures.
Input parameters
The type of message. Required. Must be one of: SMS, MMS, VOICE, EMAIL_MARKETING, EMAIL_TRANSACTIONAL, FAX, POST.
The message ID of the message. Required field to reference the specific message that has delivery issues. This should be the UUID returned when the message was sent.
The description of the delivery issue. Required field explaining what went wrong with the message delivery.
The user's email address for contact regarding this delivery issue. Required field.
Optional comments from the user providing additional context about the delivery issue.
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
CLICKSEND_CREATE_EMAIL_ADDRESSES2Tool to create an allowed email address for sending transactional emails. Use when you need to add a new sender email address to your ClickSend account. The address will need to be verified before it can be used for sending.
Input parameters
Email address to be allowed for sending transactional emails. This address will need to be verified before use.
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
CLICKSEND_CREATE_EMAIL_ADDRESSES6Tool to retrieve list of allowed email addresses for sending transactional emails. Use when you need to view verified sender addresses configured in your ClickSend account.
Input parameters
Page number for pagination. Default: 1. Minimum value is 1.
Number of records per page. Default: 15. Minimum value is 1.
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
CLICKSEND_CREATE_EMAIL_TEMPLATESTool to create a new email template from an existing master template. Use when you need to create a custom email template based on a predefined master template.
Input parameters
The intended name for the new email template. This is a user-defined name that will identify your custom template.
The ID of the master template you want to base your new template on. This references an existing master template that will serve as the foundation for the new template.
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
CLICKSEND_CREATE_FAX_RECEIPTSTool to add a test fax delivery receipt webhook URL in ClickSend. Use when you need to configure a webhook URL to receive fax delivery receipts or set it to 'poll' for manual retrieval. When successful, ClickSend sends a test receipt to verify the webhook configuration.
Input parameters
Your webhook URL where fax delivery receipt notifications will be sent. ClickSend will POST delivery status updates to this endpoint when faxes are delivered. Can also be set to 'poll' to retrieve receipts manually via the Get Fax Receipts endpoint.
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
CLICKSEND_CREATE_LISTSTool to create a new contact list in your ClickSend account. Use when you need to organize contacts into separate lists for targeted messaging campaigns. Note: API allows up to 2,000 contact lists per account.
Input parameters
The name of the contact list to create. Maximum 50 characters (longer names will be truncated). Note: Duplicate names are allowed; each list will have a unique list_id.
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
CLICKSEND_CREATE_LISTS_CONTACTSTool to create a new contact in a specific contact list in your ClickSend account. Use when you need to add a contact to a list. At least one of phone_number, email, or fax_number must be provided.
Input parameters
Contact's email address. At least one of phone_number, email, or fax_number must be provided.
The unique identifier of the contact list where the contact will be created. Must be a valid list ID from your account.
Custom field 1 for additional contact information
Custom field 2 for additional contact information
Custom field 3 for additional contact information
Custom field 4 for additional contact information
Contact's last name
Contact's fax number. At least one of phone_number, email, or fax_number must be provided.
Contact's first name
City in contact's address
Contact's phone number in E.164 format (e.g., +61411111111). At least one of phone_number, email, or fax_number must be provided.
State or province in contact's address
First line of contact's address
Second line of contact's address
Country code in contact's address. Must be a valid ISO 3166-1 alpha-2 code (2-letter country code in uppercase).
Contact's organization or company name
Postal or ZIP code in contact's address
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
CLICKSEND_CREATE_MMS_SENDTool to send MMS messages with media attachments to recipients. Use when you need to send multimedia messages with images or media files to one or more phone numbers.
Input parameters
Array of MMS message objects to send. Required - at least one message, maximum 1000 messages per API call.
Publicly accessible URL to the media file/image to be sent with the MMS. Must be a valid URL. Maximum file size: 250 kB (some older devices limited to 30 kB). 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
CLICKSEND_CREATE_POST_DIRECT_MAIL_CAMPAIGNS_SENDTool to create and send a direct mail campaign to specified locations. Use when you need to send physical mail pieces to targeted geographic areas. The campaign calculates pricing based on size, quantity, and target locations.
Input parameters
Campaign name for identification and tracking purposes.
Size of the direct mail piece. Valid values depend on the target country. Common options include 'A5' (148x210mm) and 'DL' (99x210mm envelope size). Note: Some sizes like 'A4' may not be valid for certain locations.
List of target areas with their respective quantities. Each area requires a location_id (obtained from the location search API) and quantity (typically 5000+ pieces per location). You can target multiple locations in a single campaign.
List of publicly accessible URLs pointing to PDF files for the direct mail content. Must be valid URLs to PDF files.
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
CLICKSEND_CREATE_POST_LETTERS_DETECT_ADDRESSTool to detect and convert addresses to standard format from PDF or address string. Use when you need to parse a PDF document or address string to extract structured address information. The PDF should have the recipient's name and address at the top.
Input parameters
Address string to be converted to standard format. Either 'content' or 'address' must be provided, but not both. Use newline characters to separate address lines.
Base64-encoded PDF file content. The PDF should be in standard address format with recipient's name and address at the top. Either 'content' or 'address' must be provided, but not both.
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
CLICKSEND_CREATE_POST_LETTERS_SENDTool to send physical letters through ClickSend's postal service. Use when you need to send a PDF document as a physical letter to one or more recipients. For docx/doc files, convert them first using /uploads?convert=post endpoint.
Input parameters
Whether letter is printed in colour. 0 = black and white, 1 = colour. Default is 0.
Whether letter is printed double-sided. 0 = single-sided, 1 = double-sided. Default is 0.
Source identifier for tracking purposes. Can be any string value.
URL of the PDF file to send. For docx/doc files, convert them first using the /uploads?convert=post endpoint. Supported formats: pdf, docx, doc, jpg, gif, png, bmp.
Array of recipient objects. Each recipient represents a person who will receive a copy of the letter.
Whether the letter is priority post. 0 = standard post, 1 = priority post. Default is 0.
Whether using a ClickSend template. 0 = not using template, 1 = using template. Default is 0.
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
CLICKSEND_CREATE_POST_RETURN_ADDRESSESTool to create a new post return address for ClickSend postal services. Use when you need to add a return address for sending letters or postcards through ClickSend.
Input parameters
City name for the return address. This is a required field.
Name or label for the return address. This will be used to identify the address in your account.
State, province, or region for the return address. This is an optional field but recommended.
First line of the street address. This is a required field for the return address.
Second line of the street address (apartment, suite, building, etc.). This is an optional field.
Country code for the return address (e.g., 'US', 'AU', 'GB'). This is a required field. Use ISO country codes.
Postal code or ZIP code for the return address. This is a required field.
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
CLICKSEND_CREATE_POST_RETURN_ADDRESSES3Tool to retrieve a list of all post return addresses from ClickSend account with pagination. Use when you need to view all configured return addresses for postal mail services.
Input parameters
Page number for pagination. Specifies which page of results to retrieve. Must be at least 1.
Number of records to return per page. Must be between 15 and 100. Default is 15.
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
CLICKSEND_CREATE_SMS_CAMPAIGNS_SENDTool to create and send an SMS campaign to a contact list. Use when you need to send bulk SMS messages to up to 20,000 recipients per call. Marketing messages must include opt-out mechanism.
Input parameters
The message content to send. Must include opt-out mechanism for marketing messages (e.g., 'Reply STOP to opt-out' or use StopMsg.me/xxxxx placeholder).
The sender identification. Options include: shared number, dedicated number (E.164 format like +61353787448), alpha tag (business name), or own number.
The name of the SMS campaign for identification and tracking purposes.
The ID of the contact list to send the campaign to. Use View Contact List endpoint to see available lists.
UNIX timestamp for scheduling the campaign. Defaults to 0 (send immediately).
URL to be shortened. Use http://smsg.io/xxxxx as placeholder in the message body where the shortened link should appear.
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
CLICKSEND_CREATE_SMS_EMAIL_SMS2Tool to create an allowed email address for email-to-SMS conversion. Use when you need to authorize a specific email address to send SMS messages through ClickSend's email-to-SMS gateway.
Input parameters
The SMS sender number or identifier that will be used when messages are sent from this email address.
Fax number associated with the sender (optional).
The email address to be added as an allowed address for email-to-SMS conversion. Must be a valid email address.
The subaccount ID to assign this email-to-SMS usage to for reporting purposes. Required by the API.
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
CLICKSEND_CREATE_SMS_EMAIL_SMS3Tool to retrieve a specific allowed email address for SMS email-to-SMS by its ID. Use when you need to view detailed information about a specific allowed email address configured for email-to-SMS functionality.
Input parameters
The unique identifier of the allowed email address to retrieve. Must be a valid email address ID from your 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
CLICKSEND_CREATE_SMS_EMAIL_SMS4Tool to update a specific allowed email address for email-to-SMS. Use when you need to modify an existing email address configuration including sender number, voice settings, or language preferences.
Input parameters
The SMS sender number or identifier that will be used when messages are sent from this email address.
Language code for text-to-speech conversion (if applicable). Common values include 'en-us', 'en-gb', etc.
Voice type for text-to-speech conversion (if applicable). Common values include 'female', 'male'.
The email address to update. Must be a valid email address.
The unique identifier of the allowed email address to update. Must be a valid email address ID from your 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
CLICKSEND_CREATE_SMS_EMAIL_SMS5Tool to delete a specific allowed email address from SMS email-to-SMS settings. Use when you need to remove an email address from your allowed email addresses list for email-to-SMS functionality.
Input parameters
The unique identifier of the email address to delete from allowed email addresses. Must be a valid email address ID from your 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
CLICKSEND_CREATE_SMS_EMAIL_SMS_STRIPPED_STRINGSTool to create an email to SMS stripped string rule. Use when you need to automatically remove specific text (like email signatures) from email-to-SMS messages.
Input parameters
The string to be stripped from email-to-SMS messages. When this string is encountered, everything after it (including the string itself) will be removed from the SMS message. Useful for removing email signatures.
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
CLICKSEND_CREATE_SMS_INBOUNDCreates a test inbound SMS message to verify webhook configuration in ClickSend. This generates a simulated inbound SMS that will be sent to your configured webhook URL, allowing you to test that your webhook is correctly receiving and processing inbound SMS messages. Use this to validate your webhook setup before going live with real SMS traffic.
Input parameters
The webhook URL where the test inbound SMS will be sent. Must be a valid HTTP/HTTPS URL.
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
CLICKSEND_CREATE_SMS_RECEIPTSTool to create a test SMS delivery receipt and configure the webhook URL in ClickSend. This sends a test delivery receipt to your webhook URL to verify webhook configuration is working correctly. Use when you need to test webhook integration for SMS delivery receipts or set to 'poll' for manual retrieval.
Input parameters
The webhook URL where SMS delivery receipts will be sent. Set to 'poll' to use ClickSend's system for later retrieval via the View SMS Receipt endpoint.
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
CLICKSEND_CREATE_SMS_SENDTool to send one or more SMS messages via ClickSend. Use when you need to send SMS messages to recipients. Supports up to 1000 messages per API call and provides detailed status for each message.
Input parameters
List of SMS messages to send. You can post up to 1000 messages with each API call. Each message must have 'to' and 'body' fields at minimum. The `to` field must be in full international format with '+' and country code (e.g., '+12025551234'). Optional `schedule` field accepts a Unix timestamp (seconds) to delay sending; omit to send immediately. Long or Unicode-heavy `body` values may be split into multiple SMS segments, affecting billing.
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
CLICKSEND_CREATE_SMS_TEMPLATESTool to create a new SMS template for reuse in campaigns. Use when you need to save an SMS message as a reusable template.
Input parameters
The content/message text of the SMS template. This is the actual SMS message content that will be sent when using this template.
The name of the SMS template. This is a user-defined name that will identify your custom template.
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
CLICKSEND_CREATE_SUBACCOUNTSTool to create a new subaccount in ClickSend with access permissions and credentials. Use when you need to set up a new subaccount for segregating services or users.
Input parameters
Email address for the subaccount. This is required for account notifications and communications.
Optional notes about the subaccount for reference purposes. Maximum 50 characters.
User ID to associate with the subaccount. Optional field for linking to existing user.
Password for the new subaccount. Must be a strong password for security.
Last name of the subaccount user. Required field.
First name of the subaccount user. Required field.
Access to SMPP protocol. Use 0 for no access, 1 for access granted.
Access to users management. Use 0 for no access, 1 for access granted.
Username for the new subaccount. Must be the same as the email address. This will be used for API authentication.
Phone number in international format (e.g., '+61411111111'). Required contact number for the subaccount.
Access to billing features. Use 0 for no access, 1 for access granted.
Access to contacts management. Use 0 for no access, 1 for access granted.
Access to settings. Use 0 for no access, 1 for access granted.
Access to reporting features. Use 0 for no access, 1 for access granted.
SMS de-identify message setting. Use 0 for disabled, 1 for enabled.
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
CLICKSEND_DELETE_AUTOMATIONS_SMS_INBOUNDTool to delete an inbound SMS automation rule. Use when you need to remove an existing inbound SMS automation by its rule ID.
Input parameters
Unique identifier of the inbound SMS automation rule to delete
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
CLICKSEND_DELETE_LISTSTool to delete a specific contact list from your ClickSend account. Use when you need to remove a contact list permanently.
Input parameters
The unique identifier of the contact list to delete. Must be a valid list ID from your 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
CLICKSEND_DELETE_LISTS_CONTACTSTool to delete a specific contact from a contact list in your ClickSend account. Use when you need to remove a contact from a specific list permanently.
Input parameters
The unique identifier of the contact list from which the contact will be deleted. Must be a valid list ID from your account.
The unique identifier of the contact to delete from the list. Must be a valid contact ID within the specified list.
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
CLICKSEND_DELETE_LISTS_REMOVE_OPTED_OUT_CONTACTSTool to remove all opted out contacts from a contact list using an opt out list reference. Use when you need to clean up a list by removing contacts that have opted out.
Input parameters
The unique identifier of the contact list from which opted out contacts will be removed. Must be a valid list ID from your account.
The unique identifier of the opt out list used as reference to remove opted out contacts. Must be a valid opt out list ID from your 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
CLICKSEND_DELETE_SMS_CANCELTool to cancel a scheduled SMS message by updating its status to cancelled. Use when you need to prevent a scheduled SMS from being sent.
Input parameters
Unique identifier for the scheduled SMS message to cancel (UUID format)
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
CLICKSEND_DELETE_SUBACCOUNTSTool to delete a specific subaccount from the system. Use when you need to remove a subaccount from your account.
Input parameters
The unique identifier of the subaccount to delete. Must be a valid subaccount ID from your 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
CLICKSEND_EMAIL_CAMPAIGN_GETTool to retrieve details of a specific email campaign by its ID. Use when you need to view campaign configuration, content, and delivery statistics including sends, opens, clicks, and bounces.
Input parameters
Unique identifier of the email campaign to retrieve
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
CLICKSEND_EMAIL_DELIVERY_RECEIPT_AUTOMATION_DELETETool to delete an email delivery receipt automation rule. Use when you need to remove an existing email receipt automation by its rule ID.
Input parameters
Unique identifier of the email delivery receipt automation rule to delete
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
CLICKSEND_EMAIL_DELIVERY_RECEIPT_AUTOMATION_GETRetrieves the configuration details of a specific email delivery receipt automation rule by its ID. Use this action when you need to: - View the current configuration of a specific automation rule - Check whether a rule is enabled or disabled - Verify the webhook URL or action settings for a rule - Get details before updating or deleting a rule To get the receipt_rule_id, you can first list all rules using the 'Get All Email Delivery Receipt Automations' action, or use the ID returned when creating a new rule.
Input parameters
Unique identifier of the email delivery receipt automation rule to retrieve. This ID is returned when creating a rule or can be obtained by listing all rules.
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
CLICKSEND_EMAIL_TEMPLATE_DELETETool to delete an email template by its template ID. Use when you need to remove an existing email template from your account.
Input parameters
Unique identifier of the email template to delete. Must be a valid template ID from your 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
CLICKSEND_EMAIL_TEMPLATE_GETTool to retrieve a specific user email template by its template ID. Use when you need to view details of a specific email template including its HTML content and metadata.
Input parameters
Unique identifier of the email template to retrieve. Must be a valid template ID from your 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
CLICKSEND_EMAIL_TEMPLATE_PUTTool to update an existing email template in ClickSend. Use when you need to modify the name or HTML body content of an email template.
Input parameters
The HTML content of the email template. This is the body content that will be used when sending emails using this template.
Unique identifier of the email template to update. Must be a valid template ID from your account.
The new name for the template. If not provided, the existing name will be retained.
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
CLICKSEND_EXPORT_POST_LETTERS_HISTORY_EXPORTTool to export post letter history to a downloadable CSV file. Use when you need to download historical data of post letters for analysis or record-keeping.
Input parameters
Filename to download post letters history as (e.g., 'letters_history.csv'). Should include .csv extension for proper file type detection.
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
CLICKSEND_FAX_DELIVERY_RECEIPT_AUTOMATION_DELETETool to delete a fax delivery receipt automation rule. Use when you need to remove an existing fax delivery receipt automation by its rule ID.
Input parameters
Unique identifier of the fax delivery receipt automation rule to delete
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
CLICKSEND_FAX_DELIVERY_RECEIPT_AUTOMATION_GETTool to retrieve a specific fax delivery receipt automation rule by its ID. Use when you need to view the configuration details of a fax receipt automation rule.
Input parameters
Unique identifier of the fax delivery receipt automation rule to retrieve
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
CLICKSEND_FAX_RECEIPTS_BY_MESSAGE_ID_GETTool to retrieve a single fax delivery receipt using the message identifier. Use when you need to check the status, delivery details, or cost of a specific fax transmission.
Input parameters
Unique identifier for the fax message (UUID format)
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
CLICKSEND_FAX_RECEIPTS_READ_PUTTool to mark fax delivery receipts as read in ClickSend. Use when you need to mark all receipts or receipts before a specific date as read. Optionally provide a Unix timestamp to mark only receipts created before that time.
Input parameters
Optional Unix timestamp. Mark all receipts as read that were created before this timestamp. If not provided, all receipts will be marked as read.
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
CLICKSEND_GET_ACCOUNTTool to retrieve authenticated user's account information. Use when you need to view account details such as balance, user information, settings, and billing details.
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
CLICKSEND_GET_AUTOMATIONS_EMAIL_RECEIPTSTool to retrieve all email delivery receipt automation rules configured in your ClickSend account. Use when you need to view or list all email receipt automation configurations. Supports pagination and filtering.
Input parameters
Optional search query or keyword for filtering results by rule name or action address
Page number for pagination (1-based). Default: 1
Number of records to retrieve per page. Default: 10. Note: API may use its own default page size
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
CLICKSEND_GET_AUTOMATIONS_FAX_INBOUNDTool to retrieve all inbound fax automation rules configured in your ClickSend account. Use when you need to view or list all inbound fax automation configurations. Supports pagination.
Input parameters
The page number to retrieve. Default: 1
Number of items per page (1-100). Note: ClickSend API enforces a minimum of 15 items per page. Values below 15 will be automatically adjusted to 15 by the API. Default: 15
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
CLICKSEND_GET_AUTOMATIONS_FAX_RECEIPTSTool to retrieve all fax delivery receipt automation rules configured in your ClickSend account. Use when you need to view or list all fax receipt automation configurations. Supports pagination and filtering.
Input parameters
Search query or keyword for filtering results
Page number for pagination. Default: 1
Number of records per page. Default: 10
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
CLICKSEND_GET_AUTOMATIONS_SMS_INBOUNDTool to retrieve all inbound SMS automation rules configured in your ClickSend account. Use when you need to view or list all inbound SMS automation configurations. Supports pagination and filtering.
Input parameters
Search keyword or query filter to search automation rules
Page number for pagination. Default: 1
Number of records per page. Default: 10
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
CLICKSEND_GET_AUTOMATIONS_SMS_RECEIPTSTool to retrieve all SMS delivery receipt automation rules configured in your ClickSend account. Use when you need to view or list all SMS receipt automation configurations. Supports pagination and filtering.
Input parameters
Search query to filter automation rules by rule name, action type, or action address
Page number for pagination. Default: 1
Number of records per page. Default: 10
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
CLICKSEND_GET_AUTOMATIONS_VOICE_RECEIPTSTool to retrieve all voice delivery receipt automation rules configured in your ClickSend account. Use when you need to view or list all voice receipt automation configurations. Supports pagination and filtering.
Input parameters
Search query or keyword for filtering results
Page number for pagination. Default: 1
Number of records per page. Default: 10
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
CLICKSEND_GET_CONTACT_SUGGESTIONSRetrieves contact suggestions from your ClickSend account based on recent messaging activity. Returns contacts from your lists that you may want to message, with full contact details including phone, email, address, and custom fields. Useful for finding frequently contacted recipients or planning messaging campaigns. Supports pagination via page and limit parameters.
Input parameters
Page number for pagination. Default: 1
Number of records per page. Default: 10
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
CLICKSEND_GET_COUNTRIESTool to retrieve all available country codes that ClickSend supports. Use when you need to get a list of countries for international messaging services.
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
CLICKSEND_GET_DELIVERY_ISSUESTool to retrieve all delivery issues from your ClickSend account. Use when you need to view or investigate problems with message delivery. Supports pagination for handling large result sets.
Input parameters
Page number for pagination. Default: 1
Number of records per page. Default: 10
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
CLICKSEND_GET_EMAIL_MASTER_TEMPLATESTool to retrieve all master email templates. Use when you need to view pre-designed email templates that can be used for email communications. Supports pagination.
Input parameters
Page number for pagination. Default: 1
Number of records per page. Default: 10
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
CLICKSEND_GET_EMAIL_MASTER_TEMPLATES_CATEGORIESTool to retrieve all master email template categories. Use when you need to view available categories of pre-designed email templates. Supports pagination.
Input parameters
Page number for pagination. Default: 1
Number of records per page. Default: 10
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
CLICKSEND_GET_EMAIL_TEMPLATESTool to retrieve all user email templates. Use when you need to view custom email templates created by the user. Supports pagination.
Input parameters
Page number for pagination. Default: 1
Number of records per page. Default: 10
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
CLICKSEND_GET_FAX_RECEIPTSTool to retrieve fax delivery receipts from your ClickSend account. Use when you need to view fax transmission details including delivery status, pricing, and recipient information. Supports pagination.
Input parameters
Page number for pagination. Default: 1
Number of records per page. Default: 10
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
CLICKSEND_GET_LISTSTool to retrieve all contact lists from ClickSend account with pagination support. Use when you need to view available contact lists for managing contacts and messaging campaigns.
Input parameters
Page number for paginated results. Must be at least 1.
Number of records per page. Must be at least 1.
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
CLICKSEND_GET_LISTS2Tool to retrieve a specific contact list by its list ID. Use when you need to view details of a specific contact list including its name, email ID, and contact count.
Input parameters
The unique identifier of the contact list to retrieve. Must be a valid list ID from your 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
CLICKSEND_GET_LISTS_CONTACTSTool to retrieve all contacts from a specific contact list in your ClickSend account with pagination and filtering support. Use when you need to view or process contacts within a specific list.
Input parameters
Page number for paginated results. Must be at least 1.
Number of records per page. Must be between 1 and 100.
The unique identifier of the contact list to retrieve contacts from. Must be a valid list ID from your account.
Unix timestamp to filter contacts. Returns only contacts updated after this timestamp.
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
CLICKSEND_GET_LISTS_CONTACTS2Tool to retrieve a specific contact from a contact list in your ClickSend account. Use when you need to view detailed information about a particular contact within a specific list.
Input parameters
The unique identifier of the contact list containing the contact. Must be a valid list ID from your account.
The unique identifier of the contact to retrieve. Must be a valid contact ID within the specified list.
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
CLICKSEND_GET_LISTS_EXPORTTool to export contacts from a specific list to a CSV file. Use when you need to download all contacts from a list for backup, analysis, or migration purposes.
Input parameters
The ID of the contact list to export
Filename to download the contacts list as (e.g., 'contacts_export.csv'). Must include .csv extension.
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
CLICKSEND_GET_LISTS_IMPORTTool to import contacts to a contact list from a publicly accessible file URL. Use when you need to bulk import contacts from a CSV or Excel file into a specific list. Note that the import process may be asynchronous.
Input parameters
The unique identifier of the contact list to import contacts into. Must be a valid list ID from your account.
URL of the file to process. This should be a publicly accessible URL pointing to a CSV or Excel file containing the contacts to import.
Order of fields in the file. This array specifies how the columns in your file map to contact fields. List the field names in the order they appear in your file columns. Valid field names include: phone, phone_number, first_name, last_name, email, fax_number, address_line_1, address_line_2, address_city, address_state, address_postal_code, address_country, organization_name, custom_1, custom_2, custom_3, custom_4.
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
CLICKSEND_GET_LISTS_IMPORT_CSV_PREVIEWTool to preview the first row of a CSV import file for a contact list in ClickSend. Use when you need to verify CSV structure and field mapping before importing contacts to a list.
Input parameters
The unique identifier of the contact list to preview CSV import for. Must be a valid list ID from your account.
The URL of the CSV file to preview. Must be a publicly accessible URL pointing to a CSV file containing contact data.
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
CLICKSEND_GET_LISTS_IMPORT_FIELDSTool to retrieve acceptable import fields for a contact list in ClickSend. Use when you need to view which fields are available for importing contacts into a specific list.
Input parameters
The unique identifier of the contact list to retrieve import fields for. Must be a valid list ID from your 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
CLICKSEND_GET_MMS_HISTORYTool to export MMS message history with filtering, ordering, and pagination. Use when you need to retrieve historical MMS messages with custom sorting options.
Input parameters
Custom query string for filtering results. Format: field:value pairs separated by commas (e.g., 'from:+61411111111,status_code:201')
Page number for pagination
Number of records per page
End date for filtering history as Unix timestamp (seconds since epoch)
Field to order results by. Format: 'field:order' where order is 'asc' or 'desc' (e.g., 'date_added:desc', 'date:asc')
Start date for filtering history as Unix timestamp (seconds since epoch)
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
CLICKSEND_GET_MMS_RECEIPTSTool to retrieve all MMS delivery receipts from your ClickSend account. Use when you need to view MMS delivery status, pricing, and recipient information. Supports pagination.
Input parameters
Page number for pagination. Default: 1
Number of records per page. Default: 10
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
CLICKSEND_GET_NUMBERSTool to retrieve all available dedicated numbers associated with your ClickSend account. Use when you need to view dedicated numbers that can be used as sender IDs for messaging services.
Input parameters
Page number for pagination. Must be at least 1.
Number of records per page. Must be at least 1.
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
CLICKSEND_GET_NUMBERS_SEARCHTool to search for available dedicated numbers by country code. Use when you need to find purchasable phone numbers for messaging services in a specific country.
Input parameters
Page number for pagination. Must be at least 1.
Number of records per page. Must be at least 1.
Search pattern or query to match against available phone numbers
Two-letter country code to search for available dedicated numbers (e.g., 'US', 'AU', 'GB')
Search strategy: 0 = starts with, 1 = anywhere, 2 = ends with
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
CLICKSEND_GET_POST_DIRECT_MAIL_LOCATIONS_SEARCHTool to search for direct mail locations in a specific country. Use when you need to find available locations or addresses for direct mail services.
Input parameters
Search query string to find matching locations. Can be city name, state, postal code, or address fragment.
Page number for paginated results (starts at 1). If not provided, defaults to page 1.
Country code or country name to search locations within (e.g., 'US', 'AU', 'United States')
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
CLICKSEND_GET_POST_LETTERS_HISTORYRetrieves the history of all post letters sent through ClickSend with pagination support. Use this tool to view past post letters, check their status (e.g., WaitApproval, Scheduled, delivered), review recipient details, pricing information, and delivery timestamps. Returns comprehensive details including message IDs, addresses, file URLs, and return address information for each letter.
Input parameters
Page number for pagination
Number of records per page
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
CLICKSEND_GET_PRICINGTool to retrieve pricing information for a specific country. Use when you need to check rates for SMS, MMS, and voice services in a particular country and currency.
Input parameters
Two-letter ISO country code for which to retrieve pricing (e.g., 'US', 'AU', 'GB')
Three-letter ISO currency code to display pricing in (e.g., 'USD', 'AUD', 'EUR'). If not specified, defaults to the country's default currency.
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
CLICKSEND_GET_REFERRAL_ACCOUNTSTool to retrieve a list of referral accounts with pagination support. Use when you need to view referral accounts including user information, balance, and commission details.
Input parameters
Page number for paginated results. Must be at least 1.
Number of records per page. Must be at least 1. Default is 15.
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
CLICKSEND_GET_RESELLERTool to retrieve reseller settings and account information. Use when you need to view the authenticated reseller's account details, settings, and configuration. Note: The reseller dashboard and API are only available to customers approved as resellers before January 1st, 2024.
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
CLICKSEND_GET_RESELLER_ACCOUNTSTool to retrieve a list of reseller accounts with pagination support. Use when you need to view reseller accounts including user information, balance, settings, and permissions. Note: The reseller dashboard and API are only available to customers approved as resellers before January 1st, 2024.
Input parameters
Search query for filtering results. Not case-sensitive. Format: field_name:value
Page number for paginated results. Must be at least 1.
Number of records per page. Must be at least 1. Default is 15.
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
CLICKSEND_GET_SMS_CAMPAIGNSTool to retrieve details of a specific SMS campaign by its ID. Use when you need to view campaign configuration, message content, scheduling details, and current status.
Input parameters
Unique identifier of the SMS campaign to retrieve
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
CLICKSEND_GET_SMS_CAMPAIGNS3Tool to retrieve all SMS campaigns with pagination and statistics breakdown. Use when you need to view campaign statistics and performance data for management or reporting purposes.
Input parameters
Search query in format field_name:value. Searches are not case-sensitive. Filter by fields including: sms_campaign_id, name, user_id, subaccount_id, list_id, from, body, schedule, status, date_added, custom_string, url_to_shorten, unsubscribe_link, or source.
Page number for paginated results. Must be at least 1.
Number of items to return per page. Must be between 15 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
CLICKSEND_GET_SMS_EMAIL_SMS_STRIPPED_STRINGSTool to retrieve the list of email to sms stripped string rules with pagination support. Use when you need to view all stripped string rules that automatically remove specific text from email-to-SMS messages.
Input parameters
Page number for pagination. Must be at least 1.
Number of records per page. Must be at least 1.
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
CLICKSEND_GET_SMS_HISTORYTool to retrieve sent SMS message history with filtering and pagination. Use when you need to view previously sent SMS messages or check delivery status.
Input parameters
Custom query string for filtering results. Format: field:value pairs separated by commas. Example: 'from:+61411111111,status_code:201' or 'status:Sent'. Searchable fields: status (Queued, Completed, Scheduled, WaitApproval, Failed, Cancelled, CancelledAfterReview, Received, Sent), to (recipient phone number). Searches are case-insensitive.
Page number for pagination. Used to navigate through result pages.
Number of records to return per page.
Filter messages sent up to this date. Unix timestamp format (seconds since epoch).
Logical operator for multiple search filters. Use 'AND' to match all filters or 'OR' to match any filter.
Sort results by field. Format: field:asc or field:desc (e.g., 'date:desc', 'status:asc').
Filter messages sent from this date onwards. Unix timestamp format (seconds since epoch).
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
CLICKSEND_GET_SMS_INBOUNDRetrieves inbound SMS messages received by your ClickSend account. Use this tool when you need to: - View messages sent TO your ClickSend numbers FROM customers/recipients - Search for specific messages by sender, recipient, or content - Monitor incoming SMS replies and interactions Important: To receive inbound messages via API polling, you must first configure an inbound rule in the ClickSend Dashboard with the Action set to 'POLL'. By default, only unread messages are returned.
Input parameters
Search query to filter inbound SMS messages. Format: field_name:value (e.g., from:+61437085284). Searches are case-insensitive. Available searchable fields: from (sender number), to (recipient number), message_id, body (message text). Multiple criteria can be combined using the operator parameter Malformed queries silently return zero results instead of errors.
Page number for pagination. Default: 1 Increment iteratively with consistent limit to retrieve all records.
Number of records per page. Default: 15
Search operator to combine multiple search criteria in the q parameter. Use 'AND' to match all criteria (default) or 'OR' to match any criteria. Only relevant when multiple field:value pairs are provided in the q parameter
Sort order for results. Format: field_name:direction where direction is 'asc' (ascending) or 'desc' (descending). Default is 'date:asc' (oldest first). Use 'date:desc' to get newest messages first
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
CLICKSEND_GET_SMS_RECEIPTSTool to retrieve SMS delivery receipts from your ClickSend account. Use when you need to poll and view SMS delivery status including timestamps, status codes, and error details. Requires a delivery report rule with Action set to POLL in the Dashboard.
Input parameters
Page number for pagination. Minimum: 1. Default: 1
Number of records per page. Minimum: 1. Default: 15
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
CLICKSEND_GET_SMS_TEMPLATESTool to retrieve all SMS templates from ClickSend account with pagination and filtering support. Use when you need to view available SMS templates for messaging campaigns.
Input parameters
Query parameter for filtering/searching templates. Format: field_name:value. Searches are not case-sensitive.
Page number for pagination. Default: 1
Number of records per page. Default: 15
Search operator for query parameter (AND/OR). Default: AND
Field name to sort results by
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
CLICKSEND_GET_STATISTICS_SMSTool to retrieve SMS messaging statistics for your ClickSend account. Use when you need to view usage metrics, pricing data, and date-based breakdowns of SMS message activity including outbound, inbound, and bounced messages.
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
CLICKSEND_GET_STATISTICS_VOICETool to retrieve voice messaging statistics for your ClickSend account. Use when you need to view usage metrics, pricing data, and date-based breakdowns of voice message activity.
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
CLICKSEND_GET_SUBACCOUNTSTool to retrieve all subaccounts from ClickSend account with pagination support. Use when you need to view available subaccounts and their permissions.
Input parameters
Page number for paginated results. Must be at least 1.
Number of records per page. Must be at least 1.
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
CLICKSEND_GET_SUBACCOUNTS2Tool to retrieve detailed information about a specific subaccount by its ID. Use when you need to view credentials, permissions, and contact details for a particular subaccount.
Input parameters
The unique identifier of the subaccount to retrieve. Must be a valid subaccount ID from your 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
CLICKSEND_GET_TIMEZONESTool to retrieve supported list of timezones. Use when you need to get available timezones for scheduling or configuration purposes.
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
CLICKSEND_GET_VOICE_LANGTool to retrieve all available voice languages for text-to-speech. Use when you need to get supported languages and voice options for voice messaging.
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
CLICKSEND_LIST_COUNTRIES_GETTool to retrieve the list of countries with IDs for global sending. Use when you need to select countries for international messaging operations.
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
CLICKSEND_LISTS_COPY_CONTACT_PUTTool to copy a contact from one list to another list. Use when you need to duplicate a contact from a source list to a destination list while keeping the original contact in the source list.
Input parameters
Contact ID of the contact to be copied. Must be a valid contact ID within the source list.
List ID for list you want to copy the contact to. This is the destination list ID where the contact will be duplicated.
List ID for list that contains the contact. This is the source list ID from which the contact will be copied.
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
CLICKSEND_LISTS_TRANSFER_CONTACT_PUTTool to transfer a contact from one list to another in your ClickSend account. Use when you need to move a contact between lists without deleting and recreating it.
Input parameters
The unique identifier of the contact to transfer. Must be a valid contact ID within the source list.
The unique identifier of the destination list where the contact will be transferred. Must be a valid list ID from your account.
The unique identifier of the list that currently contains the contact. Must be a valid list ID from your 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
CLICKSEND_MASTER_EMAIL_TEMPLATE_CATEGORY_GETTool to retrieve a specific master email template category by its ID. Use when you need to view details about a category of pre-designed email templates.
Input parameters
The unique identifier of the master email template category to retrieve
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
CLICKSEND_MASTER_EMAIL_TEMPLATE_GETRetrieve a specific master email template by its ID. Returns template metadata including name, creation date, and thumbnail URLs. Use this to view details of pre-designed master email templates available in ClickSend. Template IDs can be obtained from the 'Get All Master Email Templates' action.
Input parameters
The unique identifier of the master email template to retrieve. Use 'Get All Master Email Templates' to get available template IDs.
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
CLICKSEND_MASTER_EMAIL_TEMPLATES_IN_CATEGORY_GETTool to retrieve all master email templates within a specific category. Use when you need to browse pre-designed email templates from ClickSend's template library for a particular category.
Input parameters
Page number for pagination. Default: 1
Number of records to return per page. Default: 15
The unique identifier of the template category. Examples: 2 (Alerts/Notifications), 3 (Art), 4 (Birthday), 23 (Blank Template)
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
CLICKSEND_MMS_CAMPAIGNS_BY_MMS_CAMPAIGN_ID_PUTTool to update an existing MMS campaign with new parameters. Use when you need to modify campaign details such as name, sender, message body, media file, subject, or reschedule send time.
Input parameters
The text message content that will be sent in the MMS campaign.
The sender phone number in international format. This number will appear as the sender of the MMS.
The name of the campaign for identification and tracking purposes.
The ID of the contact list to send the campaign to. This must be an existing list in your ClickSend account.
The MMS subject line that will be displayed to recipients.
Unix timestamp for scheduling the campaign to be sent at a future date/time. If omitted, the campaign will not be rescheduled.
URL to the media file to attach (image/video). Must be a publicly accessible URL.
The unique identifier of the MMS campaign to update. This is required to specify which campaign to modify.
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
CLICKSEND_MMS_CAMPAIGNS_CANCEL_BY_MMS_CAMPAIGN_ID_PUTTool to cancel a scheduled MMS campaign in ClickSend. Use when you need to stop an MMS campaign from being sent. Only scheduled campaigns can be cancelled.
Input parameters
The unique identifier of the MMS campaign to cancel. Required field.
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
CLICKSEND_MMS_CAMPAIGNS_GETTool to retrieve all MMS campaigns with pagination and filtering support. Use when you need to view existing MMS campaigns for management or reporting purposes.
Input parameters
Search query string to filter campaigns by name or other fields
Page number for paginated results. Must be at least 1.
Number of items to return per page. Must be between 15 and 100.
Search operator to combine query terms. Use 'AND' or 'OR'.
Field name to sort results by (e.g., 'date_added', 'name')
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
CLICKSEND_MMS_CAMPAIGNS_PRICE_POSTTool to calculate the price for an MMS campaign before sending. Use when you need to estimate costs for an MMS campaign to a contact list.
Input parameters
The text content of the MMS message that will be sent to contacts.
The sender phone number in E.164 international format (must start with + followed by country code and number, e.g., +61411111111).
The name you want to give this MMS campaign for identification purposes.
The ID of the contact list to calculate the price for. Must be a valid list ID from your account that contains at least one contact.
The subject line for the MMS message.
Publicly accessible URL of the media file (image/video) to include in the MMS. The API will validate that this URL is reachable before calculating the price.
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
CLICKSEND_MMS_CAMPAIGNS_SEND_POSTTool to create and send an MMS campaign to a contact list with multimedia content. Use when you need to send MMS messages to multiple recipients with images or videos. The campaign sends immediately unless scheduled for future delivery.
Input parameters
The text message content that will be sent in the MMS campaign.
Your sender ID or phone number. If omitted, uses account default. Refer to ClickSend documentation for valid sender IDs.
Campaign name for identification and tracking purposes.
The ID of the contact list to send the campaign to. This must be an existing list in your ClickSend account.
Subject line of the MMS campaign.
Unix timestamp for scheduling the campaign to be sent at a future date/time. If omitted, the campaign sends immediately.
URL pointing to the media file (image/video) to include in the MMS. Must be a publicly accessible URL.
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
CLICKSEND_MMS_HISTORY_EXPORT_GETTool to export MMS message history to a CSV file. Supports filtering by query string, date range, ordering, and limiting results. Use when you need to download historical MMS messages for analysis or archival purposes.
Input parameters
Custom query string for filtering results. Format: field:value pairs separated by commas (e.g., 'from:+61411111111,status_code:201')
Maximum number of records to export. Use to limit the export size
End date for filtering history as Unix timestamp (seconds since epoch)
Filename to download MMS history as (e.g., 'mms_history_export.csv')
Field to order results by. Format: 'field:order' where order is 'asc' or 'desc' (e.g., 'date_added:desc', 'date:asc')
Start date for filtering history as Unix timestamp (seconds since epoch)
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
CLICKSEND_MMS_PRICE_POSTTool to calculate the price for sending MMS messages without actually sending them. Use when you need to estimate the cost of MMS messages before sending.
Input parameters
Array of message objects to calculate price for. Required - at least one message.
URL of the media file to send with the MMS (e.g., image URL). 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
CLICKSEND_MMS_RECEIPTS_READ_PUTTool to mark MMS delivery receipts as read in ClickSend. Use when you need to mark all receipts or receipts before a specific date as read. Optionally provide a Unix timestamp to mark only receipts created before that time.
Input parameters
Optional Unix timestamp. Mark all receipts as read that were created before this timestamp. If not provided, all receipts will be marked as read.
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
CLICKSEND_POST_NUMBERS_BUYTool to purchase a dedicated phone number from ClickSend. Use when you need to buy a specific number for SMS messaging and other communication services.
Input parameters
The type of service for the number (e.g., 'sms')
Two-character ISO country code (e.g., 'US', 'AU')
The phone number to purchase, including country code (e.g., '+14155551234')
Registration information for compliance purposes.
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
CLICKSEND_POST_RETURN_ADDRESSES_BY_RETURN_ADDRESS_ID_DELETETool to delete a specific post return address from the system. Use when you need to remove a return address from your postal mailings.
Input parameters
The unique identifier of the post return address to delete. Must be a valid return address ID from your 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
CLICKSEND_POST_RETURN_ADDRESSES_BY_RETURN_ADDRESS_ID_GETTool to retrieve a specific post return address by its unique identifier. Use when you need to view details of a return address for postal services.
Input parameters
The unique identifier of the post return address to retrieve. Must be a valid return address ID from your 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
CLICKSEND_POST_RETURN_ADDRESSES_BY_RETURN_ADDRESS_ID_PUTTool to update an existing post return address in ClickSend. Use when you need to modify the details of a return address for postal mail services.
Input parameters
Your city. This is a required field for the city name.
Your address name. This is a required field that identifies the return address.
Your state. This is an optional field for the state, province, or region.
Your address line 1. This is a required field for the primary street address.
Your address line 2. This is an optional field for additional address details like apartment, suite, or floor number.
Your country. This is a required field for the country code (e.g., 'AU' for Australia).
The unique identifier of the post return address to update. Must be a valid return address ID from your account.
Your postal code. This is a required field for the postal or ZIP code.
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
CLICKSEND_POST_UPLOADSTool to upload and optionally convert files for use with ClickSend messaging services. Use when you need to upload files for fax, MMS, postcards, or post services. All uploaded files expire 10 minutes after upload.
Input parameters
Your base64 encoded file string. The file content should be encoded in base64 format before uploading.
Conversion type for the uploaded file. Valid values: 'fax', 'mms', 'postcard', 'post', 'csv'. Converts the file to the appropriate format for the specified service. If not specified, the file is uploaded without conversion.
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
CLICKSEND_PUT_FORGOT_PASSWORDInitiates password recovery for a ClickSend account by sending a password reset link via email. Use this tool when a user has forgotten their password and needs to reset it. The API will send an email to the account's registered email address with a link/token to reset the password. Note: Accounts configured for OAuth/Google authentication cannot use this endpoint and will return a 400 status with an explanatory message.
Input parameters
The username or email address of the ClickSend account that needs password recovery. This can be either an email format (e.g., 'user@example.com') or a simple alphanumeric username (e.g., 'myusername').
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
CLICKSEND_PUT_FORGOT_USERNAMETool to retrieve forgotten username by providing registered email or phone number. Use when a user needs to recover their account username via notification.
Input parameters
Email address registered to the account. Either email or phone_number must be provided.
Phone number registered to the account in E.164 format or local format. Either email or phone_number must be provided.
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
CLICKSEND_RECHARGE_PACKAGES_GETTool to retrieve all available recharge packages from ClickSend. Use when you need to view pricing and quantity information for SMS, voice, fax, email, and postal mail services.
Input parameters
Country code to filter packages by specific country (e.g., 'US', 'AU', 'GB').
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
CLICKSEND_RECHARGE_PURCHASE_BY_PACKAGE_ID_PUTPurchase a recharge package by package ID to add credits to a ClickSend account. Before using this action, call 'Get Recharge Packages' to retrieve available package IDs and their pricing. This action requires a valid payment method configured on the account. In test/sandbox environments, this may return a payment gateway error if no payment method is configured. Common error responses: - 404 "Customer token not found": No payment method configured - 404 "Package not found": Invalid package ID - 401 "Authorization failed": Authentication issue
Input parameters
ID of the recharge package to purchase. Must be a positive integer. Use the 'Get Recharge Packages' action first to retrieve available package IDs and their pricing details.
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
CLICKSEND_RECHARGE_TRANSACTIONS_GETTool to retrieve all recharge transactions from ClickSend account with pagination support. Use when you need to view transaction history including amounts, currencies, and dates.
Input parameters
Page number for pagination. Must be at least 1.
Number of records per page. Must be at least 1.
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
CLICKSEND_RECHARGE_TXNS_BY_TXN_ID_GETTool to retrieve details of a specific recharge transaction by transaction ID. Use when you need to view transaction information such as amount, currency, invoice number, and date.
Input parameters
The unique identifier of the recharge transaction to retrieve
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
CLICKSEND_SEARCH_CONTACTS_LISTS_GETSearch for contact lists and individual contacts in your ClickSend account by name with pagination support. Returns both contact lists (type='list') and individual contacts (type='contact') that match the search query. Search is case-insensitive and matches partial names. Use when you need to find specific contact lists or contacts by name.
Input parameters
Search query string to filter contact lists and contacts by name. Search is case-insensitive and matches partial names.
Page number for paginated results. Must be at least 1.
Number of records per page. Must be at least 1.
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
CLICKSEND_SEND_VERIFICATION_TOKEN_GETTool to send a verification email containing an activation token to a registered email address. Use when you need to verify an email address before it can be used to send email campaigns through ClickSend.
Input parameters
The unique identifier of the email address to send verification to. This ID is returned when creating an email address via the ClickSend API.
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
CLICKSEND_SMS_CAMPAIGNS_CANCEL_BY_SMS_CAMPAIGN_ID_PUTTool to cancel a scheduled SMS campaign in ClickSend. Use when you need to stop an SMS campaign from being sent. Only scheduled campaigns can be cancelled.
Input parameters
The unique identifier of the SMS campaign to cancel. Required field.
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
CLICKSEND_SMS_CANCEL_ALL_PUTTool to cancel all scheduled SMS messages in ClickSend. Use this when you need to cancel pending scheduled SMS messages in bulk. Only affects messages that are scheduled for future delivery and have not yet been sent. Key behaviors: - Without custom_string: Cancels ALL scheduled SMS messages in the account - With custom_string: Cancels only scheduled messages matching that specific custom_string identifier - Returns the count of messages that were successfully cancelled - Does not affect messages that have already been sent or are currently being sent - This operation is idempotent - calling it multiple times has the same effect
Input parameters
Optional filter to cancel only scheduled messages with this specific custom_string value. If not provided, cancels all scheduled SMS messages. Use this when you want to cancel a specific batch of scheduled messages that were sent with the same custom_string identifier.
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
CLICKSEND_SMS_DELIVERY_RECEIPT_AUTOMATION_DELETETool to delete an SMS delivery receipt automation rule. Use when you need to remove an existing delivery receipt automation by its rule ID.
Input parameters
Unique identifier of the SMS delivery receipt automation rule to delete
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
CLICKSEND_SMS_DELIVERY_RECEIPT_AUTOMATION_GETTool to retrieve a specific SMS delivery receipt automation rule by its ID. Use when you need to view the configuration details of an SMS receipt automation rule.
Input parameters
Unique identifier of the SMS delivery receipt automation rule to retrieve
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
CLICKSEND_SMS_EMAIL_SMS_STRIPPED_STRING_DELETETool to delete an email to SMS stripped string rule from the account. Use when you need to remove an existing stripped string rule by its rule ID.
Input parameters
The unique identifier of the stripped string rule to delete. Must be a valid rule ID from your 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
CLICKSEND_SMS_EMAIL_SMS_STRIPPED_STRING_GETTool to retrieve an email to SMS stripped string rule by its ID. Use when you need to view the details of a specific stripped string rule.
Input parameters
The unique identifier of the stripped string rule to retrieve. Must be a valid rule ID from your 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
CLICKSEND_SMS_EMAIL_SMS_STRIPPED_STRING_PUTTool to update an email to SMS stripped string rule. Use when you need to modify the text pattern that is stripped from emails before converting to SMS.
Input parameters
The unique identifier of the stripped string rule to update. Must be a valid rule ID from your account.
The new text string/pattern to be stripped from emails before SMS conversion. This will replace the existing stripped string for this rule.
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
CLICKSEND_SMS_HISTORY_EXPORT_GETTool to export all SMS message history to a CSV file. Downloads a complete export of your SMS history. Use when you need to download all historical SMS messages for analysis, reporting, backup, or archival purposes. Note: This exports all SMS history without filtering - use 'Get SMS History' action first if you need to filter by date, status, or other criteria before deciding to export.
Input parameters
Filename to download SMS history as (e.g., 'sms_history_export.csv')
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
CLICKSEND_SMS_INBOUND_AUTOMATION_GETTool to retrieve a specific inbound SMS automation rule by its ID. Use when you need to view the configuration details of an inbound SMS automation rule.
Input parameters
Unique identifier of the inbound SMS automation rule to retrieve
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
CLICKSEND_SMS_INBOUND_AUTOMATION_PUTTool to update an existing inbound SMS automation rule in ClickSend. Use when you need to modify automated actions for inbound SMS messages.
Input parameters
Action to perform when rule matches. Valid values: AUTO_REPLY, EMAIL_USER, EMAIL_FIXED, URL, SMS, POLL, GROUP_SMS, MOVE_CONTACT, CREATE_CONTACT, CREATE_CONTACT_PLUS_EMAIL, CREATE_CONTACT_PLUS_NAME_EMAIL, CREATE_CONTACT_PLUS_NAME, SMPP, NONE.
Controls activation status of the rule. 0 = disabled, 1 = enabled.
Name of the automation rule to identify it. Helps organize and manage multiple rules.
Webhook format type. Valid values: 'post', 'get', or 'json'. Defaults to 'post' if not specified.
Target destination for the specified action. For EMAIL_FIXED provide email address, for URL provide webhook URL, for contact lists provide list ID.
Unique identifier of the inbound SMS automation rule to update
The dedicated phone number to apply this rule to. Use '*' to apply the rule to all numbers.
Text pattern to match against incoming messages. Can be null for message_search_type=0 (any message).
Message matching logic. 0 = Any message, 1 = starts with, 2 = contains, 3 = does not contain.
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
CLICKSEND_SMS_INBOUND_READ_BY_MESSAGE_ID_PUTTool to mark a specific inbound SMS message as read in ClickSend. Use when you need to mark an individual inbound SMS as processed. Once marked as read, the message won't appear in the View Inbound SMS endpoint but can still be viewed using the View Specific Inbound SMS endpoint.
Input parameters
The identifier for the inbound SMS to mark as read. This is the message_id of the inbound message sent by the recipient (not the original_message_id of the outbound message).
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
CLICKSEND_SMS_INBOUND_READ_PUTMark inbound SMS messages as read in ClickSend. Use this action to mark all inbound SMS messages as read, or only those received before a specific timestamp. This is commonly used after polling for new messages with GET /sms/inbound to prevent re-reading the same messages. Once marked as read, messages will no longer appear in the default View Inbound SMS (GET /sms/inbound) response, but remain accessible via the View Specific Inbound SMS by Message ID endpoint. The operation is idempotent - marking already-read messages has no negative effect.
Input parameters
Unix timestamp (in seconds since epoch). If provided, only inbound SMS received before this timestamp will be marked as read. If omitted, ALL unread inbound messages will be marked as read. For incremental polling, use the 'timestamp' value from the last message in your previous GET /sms/inbound response to avoid marking future messages.
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
CLICKSEND_SMS_PRICE_POSTTool to calculate the price for sending SMS messages without actually sending them. Use when you need to estimate the cost of SMS messages before sending.
Input parameters
Array of SMS message objects to calculate price for. Required - at least one message.
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
CLICKSEND_SMS_RECEIPTS_BY_MESSAGE_ID_GETTool to retrieve a single SMS delivery receipt using the message identifier. Use when you need to check the status, delivery details, or cost of a specific SMS transmission.
Input parameters
Unique identifier for the SMS message (UUID format)
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
CLICKSEND_SMS_RECEIPTS_READ_PUTTool to mark SMS delivery receipts as read in ClickSend. Use when you need to mark receipts as processed so they no longer appear in the View SMS Receipts endpoint. Optionally specify a date threshold to mark only receipts received before a certain time.
Input parameters
Unix timestamp. Receipts received before this time will be marked as read. If not provided, all receipts will be marked as read.
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
CLICKSEND_SMS_TEMPLATES_BY_TEMPLATE_ID_DELETETool to delete an SMS template by its template ID. Use when you need to remove an existing SMS template from your account.
Input parameters
Unique identifier of the SMS template to delete. Must be a valid template ID from your 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
CLICKSEND_SMS_TEMPLATES_BY_TEMPLATE_ID_PUTTool to update an existing SMS template in ClickSend. Use when you need to modify the name or body content of an SMS template.
Input parameters
The text content of the SMS template. This is the body content that will be used when sending SMS messages using this template. If not provided, the existing body will be retained.
Unique identifier of the SMS template to update. Must be a valid template ID from your account.
The new name for the template. If not provided, the existing name will be retained.
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
CLICKSEND_SPECIFIC_ALLOWED_EMAIL_ADDRESS_DELETETool to delete a specific allowed email address from the account. Use when you need to remove an email address from your allowed email addresses list.
Input parameters
The unique identifier of the email address to delete. Must be a valid email address ID from your 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
CLICKSEND_SPECIFIC_ALLOWED_EMAIL_ADDRESS_GETTool to retrieve a specific allowed email address by its ID. Use when you need to view detailed information about a specific email address in your account.
Input parameters
The unique identifier for the allowed email address to retrieve. Use the 'Get Allowed Email Addresses' action to list available email addresses and obtain their IDs.
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
CLICKSEND_SUBACCOUNTS_REGEN_API_KEY_BY_SUBACCOUNT_ID_PUTTool to regenerate API key for a specific subaccount. Use when you need to create a new API key for security purposes or when the current key has been compromised.
Input parameters
The unique identifier of the subaccount to regenerate API key for. Must be a valid subaccount ID from your 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
CLICKSEND_UPDATE_ACCOUNTTool to update authenticated user's account information. Use when you need to modify account details such as first name, last name, phone number, or country.
Input parameters
User's country code (ISO 3166-1 alpha-2 format, e.g., 'US', 'AU', 'GB')
User's phone number in E.164 format (e.g., '+16068249028')
User's last name to update
User's first name to update
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
CLICKSEND_UPDATE_AUTOMATIONS_EMAIL_RECEIPTSTool to update an email delivery receipt automation rule in ClickSend. Use when you need to modify an existing email receipt automation rule by its rule ID.
Input parameters
Determines the response type when rule matches. Supported options: AUTO_REPLY, EMAIL_USER, EMAIL_FIXED, URL, SMS, POLL, GROUP_SMS, MOVE_CONTACT, CREATE_CONTACT. Optional - only specify if you want to update the action type.
Controls activation status of the rule. 0 = disabled, 1 = enabled.
Name to identify the automation rule. Helps organize and manage multiple rules. Optional - only specify if you want to update the rule name.
Specifies match criteria for the delivery receipt. 0 = match all reports. Nullable integer value for matching criteria. Optional - only specify if you want to update the match type.
Designates the target destination or endpoint for the triggered action (e.g., URL endpoint or email address).
The unique identifier of the receipt rule to update
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
CLICKSEND_UPDATE_AUTOMATIONS_FAX_INBOUNDTool to update an inbound fax automation rule in ClickSend. Use when you need to modify an existing fax inbound automation rule by its rule ID.
Input parameters
The action to perform when a fax is received. Supported actions: AUTO_REPLY, EMAIL_USER, EMAIL_FIXED, URL, SMS, POLL, GROUP_SMS, MOVE_CONTACT, CREATE_CONTACT, CREATE_CONTACT_PLUS_EMAIL, CREATE_CONTACT_PLUS_NAME_EMAIL, CREATE_CONTACT_PLUS_NAME, SMPP, NONE.
Controls activation status of the rule. 0 = disabled, 1 = enabled.
Name of the automation rule to identify it. Helps organize and manage multiple rules.
The destination address for the action. For EMAIL_FIXED action, provide an email address. For URL action, provide a webhook URL. For SMS, provide phone number.
The unique identifier of the inbound rule to update
The dedicated fax number to apply this rule to. Use '*' to apply the rule to all fax numbers.
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
CLICKSEND_UPDATE_AUTOMATIONS_FAX_RECEIPTSTool to update a fax delivery receipt automation rule in ClickSend. Use when you need to modify an existing fax receipt automation rule by its rule ID.
Input parameters
Determines the response type when rule matches. Supported options: AUTO_REPLY, EMAIL_USER, EMAIL_FIXED, URL, SMS, POLL, GROUP_SMS, MOVE_CONTACT, CREATE_CONTACT, CREATE_CONTACT_PLUS_EMAIL, CREATE_CONTACT_PLUS_NAME_EMAIL, CREATE_CONTACT_PLUS_NAME, SMPP, NONE.
Controls activation status of the rule. 0 = disabled, 1 = enabled.
Name to identify the automation rule. Helps organize and manage multiple rules.
Specifies match criteria for the delivery receipt. 0 = match all reports.
Designates the target destination or endpoint for the triggered action (e.g., URL endpoint or email address).
The unique identifier of the receipt rule to update
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
CLICKSEND_UPDATE_AUTOMATIONS_SMS_RECEIPTSTool to update an SMS delivery receipt automation rule in ClickSend. Use when you need to modify an existing SMS receipt automation rule by its rule ID.
Input parameters
Determines the response type when rule matches. Valid values: AUTO_REPLY, EMAIL_USER, EMAIL_FIXED, URL, SMS, POLL, GROUP_SMS, MOVE_CONTACT, CREATE_CONTACT, CREATE_CONTACT_PLUS_EMAIL, CREATE_CONTACT_PLUS_NAME_EMAIL, CREATE_CONTACT_PLUS_NAME, SMPP, or NONE.
Controls activation status of the rule. 0 = disabled, 1 = enabled.
Name to identify the automation rule. Helps organize and manage multiple rules.
Specifies match criteria for the delivery receipt. Valid values: 0 (match all reports), 1, or 2 (specific match types).
Specifies where the action should be directed (e.g., email address for EMAIL_FIXED action, URL for URL action).
The unique identifier of the receipt rule to update
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
CLICKSEND_UPDATE_LISTSTool to update the name of a specific contact list in your ClickSend account. Use when you need to rename an existing contact list.
Input parameters
The unique identifier of the contact list to update. Must be a valid list ID from your account.
The new name for the contact list. This will replace the existing list name.
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
CLICKSEND_UPDATE_LISTS_CONTACTSTool to update a specific contact in a contact list in your ClickSend account. Use when you need to modify contact details such as phone number, email, name, address, or custom fields.
Input parameters
Contact's email address. At least one contact method (phone_number, email, or fax_number) must be provided.
The unique identifier of the contact list containing the contact. Must be a valid list ID from your account.
Custom field 1 for additional contact information
Custom field 2 for additional contact information
Custom field 3 for additional contact information
Custom field 4 for additional contact information
Contact's last name
The unique identifier of the contact to update. Must be a valid contact ID within the specified list.
Contact's fax number. At least one contact method (phone_number, email, or fax_number) must be provided.
Contact's first name
City in contact's address
Contact's phone number in E.164 format (e.g., '+14155552999'). At least one contact method (phone_number, email, or fax_number) must be provided.
State or province in contact's address
First line of contact's street address
Second line of contact's address (apartment, suite, etc.)
Country code in ISO 3166 format (2-letter country code) for contact's address
Contact's organization or company name
Postal or ZIP code in contact's address
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
CLICKSEND_UPDATE_RECHARGE_CREDIT_CARDRetrieve stored credit card payment information in tokenized/masked form. This tool retrieves the credit card details currently saved for account recharge operations. Returns masked card number (format: XXXX-XXXX-XXXX-0000), expiry date, and cardholder name. ClickSend does not store actual card numbers - only secure tokens. Use this when you need to: - Check what credit card is currently stored for auto-recharge - Verify cardholder details - Confirm card expiration date before recharge operations Returns 404 if no credit card is stored on the account. Note: This is a read-only GET action. To update credit card details, use ClicksendUpdateRechargeCreditCard2 instead.
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
CLICKSEND_UPDATE_RESELLERTool to update reseller account settings and configuration. Use when you need to modify reseller details such as contact information, billing settings, timezone, or feature settings. Note: The reseller dashboard and API are only available to customers approved as resellers before January 1st, 2024.
Input parameters
Two-letter ISO country code for the reseller's location (e.g., 'US', 'AU', 'GB')
IANA timezone identifier for scheduling and timestamps (e.g., 'Australia/Melbourne', 'America/New_York')
Reseller's contact email address
Reseller's contact phone number in international format
Display name for the reseller account or business
Whether to automatically recharge account when credits fall below threshold: 1 to enable, 0 to disable
Reseller's last name
Reseller's first name
Credit balance threshold that triggers auto-recharge (decimal string, e.g., '50.00')
Default country code for SMS recipients when not specified (e.g., 'US', 'AU', 'GB')
Whether to allow Unicode characters in SMS messages: 1 to enable, 0 to restrict to GSM 7-bit characters
Amount in account currency to add when auto-recharge triggers (decimal string, e.g., '100.00')
Email address for billing notifications and invoices
Whether sender ID is locked and cannot be changed per message: 1 to lock sender ID, 0 to allow per-message customization
Mobile phone number for billing alerts in international format
Whether to use email subject line as SMS message body when sending via email-to-SMS: 1 to enable, 0 to use email body
Maximum character limit per SMS message (typical values: 160 for single SMS, 320 for concatenated)
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
CLICKSEND_UPDATE_SMS_CAMPAIGNSUpdate an existing SMS campaign. Modify campaign details including name, message content, contact list, sender ID, or schedule time. IMPORTANT: Only scheduled campaigns (with future send time) can be updated. Once a campaign is sent or queued for immediate sending, it cannot be modified. When updating, always include the 'schedule' parameter with a future timestamp to keep the campaign editable.
Input parameters
The message content for your campaign. This is the SMS text that will be sent to contacts.
Your sender ID. This is the sender name or number that recipients will see. See ClickSend sender ID documentation for requirements.
The title assigned to your campaign. This will replace the existing campaign name.
Identifier for your contact list. The contact list that the campaign should use.
Unix timestamp for when to send the campaign. IMPORTANT: If omitted or set to 0, the campaign sends immediately and cannot be updated again. To keep a campaign editable, set this to a future timestamp. Maximum 4 months in advance.
A URL to compress and include in the message. Insert placeholder text in body where the shortened URL should appear.
The unique identifier of the SMS campaign to update. Must be a valid campaign ID from your 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
CLICKSEND_UPDATE_SUBACCOUNTSTool to update a specific subaccount's details and permissions in ClickSend. Use when you need to modify subaccount credentials, contact information, or access permissions.
Input parameters
New email address for the subaccount. This is required for account notifications and communications.
New password for the subaccount. Must be a strong password for security. When provided, old_password is also required.
Last name of the subaccount user. Required field for personalization.
First name of the subaccount user. Required field for personalization.
Access permission for users management. Use 0 for no access, 1 for access granted. Defaults to 1.
New API username for the subaccount. This will be used for API authentication.
Current password for the subaccount. Required only when updating the password field.
Phone number in E.164 format (e.g., '+61411111111'). Required contact number for the subaccount.
The unique identifier of the subaccount to update. Must be a valid subaccount ID from your account.
Access permission for billing features. Use 0 for no access, 1 for access granted. Defaults to 1.
Access permission for contacts management. Use 0 for no access, 1 for access granted. Defaults to 0.
Access permission for settings. Use 0 for no access, 1 for access granted. Defaults to 1.
Access permission for reporting features. Use 0 for no access, 1 for access granted. Defaults to 1.
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
CLICKSEND_USER_COUNTRIES_AGREE_POSTAgrees to the rules and regulations for all previously selected countries in Global Sending. This action confirms acceptance of the regulatory requirements and content restrictions for countries that have been selected via POST /user-countries. After agreeing, the action returns a detailed list of all selected countries including their specific regulatory requirements, registration status, and any additional compliance information needed for sending SMS/MMS to those regions. Use this after selecting countries for international messaging to formally acknowledge compliance with their sending rules. The response includes critical information such as content restrictions (e.g., no gambling, adult content), registration requirements, and links to detailed country-specific guidelines. This is typically part of a workflow: 1) Get available countries (GET /country-list) → 2) Select countries (POST /user-countries) → 3) Agree to rules (this action) → 4) Begin sending messages.
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
CLICKSEND_USER_COUNTRIES_GETTool to retrieve the list of selected countries for Global Sending. Use when you need to view which countries are currently enabled for international messaging.
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
CLICKSEND_USER_COUNTRIES_POSTTool to select countries for Global SMS/MMS sending. Use when you need to configure which countries are enabled for international messaging. To remove/unselect a country, exclude its ID from the array.
Input parameters
Array of country IDs to enable for SMS/MMS sending. Country IDs can be obtained from GET /country-list endpoint. To remove/unselect a country, exclude its ID from this array.
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
CLICKSEND_VERIFY_ALLOWED_EMAIL_ADDRESS_GETVerify an email address using its activation token to enable it as a sender address for email campaigns. This action completes the email address verification process after: 1. Creating an allowed email address (via Create Allowed Email Address action) 2. Requesting a verification email (via Send Email Verification Token action) 3. Retrieving the activation token from the email inbox A verified email address is required before it can be used as a sender address for transactional emails and email campaigns through ClickSend.
Input parameters
The activation/verification token that was sent to the email address. This token is delivered to the email address after creating it and requesting a verification email via the Send Email Verification Token action.
The unique identifier for the allowed email address that needs verification. This ID is returned when creating an email address via the Create Allowed Email Address 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
CLICKSEND_VERIFY_FORGOT_PASSWORD_VERIFYTool to verify forgot password request and reset user password. Use in the second step of password reset flow after receiving the activation token via email.
Input parameters
The new password to be set for the account
The identifier for the subaccount that needs password reset
The verification token/code received via email from the forgot password request
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
CLICKSEND_VOICE_CANCEL_ALL_PUTTool to cancel all scheduled voice messages in ClickSend. Use when you need to cancel all pending scheduled voice messages at once. Only affects scheduled messages that have not yet been sent.
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
CLICKSEND_VOICE_DELIVERY_RECEIPT_AUTOMATION_DELETETool to delete a voice delivery receipt automation rule. Use when you need to remove a specific voice receipt automation rule.
Input parameters
The unique identifier of the voice delivery receipt automation rule to delete.
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
CLICKSEND_VOICE_DELIVERY_RECEIPT_AUTOMATION_GETTool to retrieve a specific voice delivery receipt automation rule by its ID. Use when you need to view the configuration details of a voice receipt automation rule.
Input parameters
Unique identifier of the voice delivery receipt automation rule to retrieve
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
CLICKSEND_VOICE_DELIVERY_RECEIPT_AUTOMATION_PUTTool to update a voice delivery receipt automation rule in ClickSend. Use when you need to modify the configuration of an existing voice receipt automation rule. Important: This endpoint requires ALL fields (rule_name, match_type, action, action_address, enabled) to be provided in the update request. To update a rule, first retrieve its current values using the GET endpoint, then send the complete updated configuration.
Input parameters
Response action to perform when rule matches (e.g., 'URL' for webhook, 'EMAIL_FIXED' for email notification).
Controls activation status of the rule. 0 = disabled, 1 = enabled.
Name to identify the automation rule. Helps organize and manage multiple rules.
Determines which delivery statuses trigger the rule. Valid values: 0 = All delivery reports, 1-2 = Specific status filters.
Target destination for the action - URL endpoint or email address where delivery receipts will be sent.
Unique identifier of the voice delivery receipt automation rule to update
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
CLICKSEND_VOICE_HISTORY_EXPORT_GETTool to export all voice history to a CSV file. Use when you need to download a complete history of voice messages sent from your ClickSend account. Returns a downloadable file containing voice message records including timestamps, recipients, status, and other details. Note: This action requires existing voice message history; it will fail with a clear message if no voice messages have been sent.
Input parameters
Filename for the downloaded voice history export. Must be a valid filename with .csv extension. The file will contain all voice message history from your ClickSend 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
CLICKSEND_VOICE_RECEIPTS_READ_PUTTool to mark voice delivery receipts as read in ClickSend. Use when you need to mark all voice receipts or receipts before a specific date as read to prevent them from appearing in subsequent GET requests. Optionally provide a Unix timestamp to mark only receipts received before that time.
Input parameters
Optional Unix timestamp. Mark all voice delivery receipts as read before this timestamp. If not provided, all voice receipts will be marked as read.
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
No publicly available marketplace agent is found using this tool yet. There are 30 agents privately built on Nagent that already use ClickSend.
Build on Nagent
Connect ClickSend to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find ClickSend, and click "Connect Now." You'll authenticate with BASIC — Nagent handles credential storage and refresh automatically. Once connected, ClickSend is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once ClickSend is connected, you configure its 166 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop ClickSend steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a ClickSend event fires, the agent kicks off automatically.
Every ClickSend action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While ClickSend ships with 166 pre-built phone & sms actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching ClickSend together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build ClickSend-based workflows tailored to your business.