Lusha connects to a Nagent workspace with an API key. Once it is connected, agents can call 7 Lusha actions, such as "Create Subscription", "Get Audit Logs" and "Get Audit Log Stats". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Lusha, with input parameters and output schema.
LUSHA_CREATE_SUBSCRIPTIONTool to create one or more webhook subscriptions for real-time signal notifications. Use when you want to subscribe to Lusha signals (job changes, company updates, etc.) and receive real-time webhook notifications. Maximum 25 subscriptions per request. Example use case: Set up a webhook to notify your system whenever a contact gets a job title promotion or a company has a funding event.
Input parameters
Default subscription name prefix.
Default values applied to all subscriptions. Required fields: url. Optional fields: entityType, signalTypes.
Array of subscriptions to create (max 25 in production).
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
LUSHA_DELETE_SUBSCRIPTIONSDelete one or more webhook subscriptions by their IDs. Use this action to remove webhook subscriptions from your Lusha account. The action supports batch deletion of up to 25 subscriptions per request. Returns a summary with success and failure counts for each subscription.
Input parameters
Array of subscription IDs to delete. Maximum 25 IDs per 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
LUSHA_GET_AUDIT_LOGSRetrieve audit logs for your account including API calls and webhook deliveries. Use when you need to review delivery status, errors, and performance metrics for webhooks and API requests in your Lusha account.
Input parameters
Maximum number of results (1-100)
Number of results to skip
Status of audit log delivery.
Filter by subscription 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
LUSHA_GET_AUDIT_LOG_STATSRetrieve aggregated statistics for audit logs. Returns total count, successful count, failed count, and success rate percentage. Use this to monitor audit log activity and delivery success rates.
Input parameters
Filter statistics by subscription 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
LUSHA_GET_SUBSCRIPTIONTool to get details of a specific webhook subscription by ID. Use when you need to retrieve information about an existing webhook subscription including its status, configuration, and entity details.
Input parameters
The unique identifier of the subscription 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
LUSHA_LIST_SUBSCRIPTIONSList all webhook subscriptions for your account with pagination support. Use when you want to retrieve all configured webhook subscriptions to review their settings, check active status, or manage your webhook integrations. Example use case: Get a paginated list of all your webhook subscriptions to review which contacts or companies you're tracking.
Input parameters
Maximum number of results (1-100)
Number of results to skip
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
LUSHA_UPDATE_SUBSCRIPTIONUpdate an existing webhook subscription configuration. Use this action to modify an existing webhook subscription's settings such as name, webhook URL, active status, and signal types. Optionally, you can regenerate the webhook secret for enhanced security.
Input parameters
The unique identifier of the subscription to update.
New webhook URL.
New subscription name.
Enable or disable subscription.
New signal types to subscribe to.
Generate new webhook secret (secret will be returned in response).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 7 Lusha actions on Nagent, including "Create Subscription", "Get Audit Logs" and "Get Audit Log Stats". Create Subscription: Create one or more webhook subscriptions for real-time signal notifications. Each action is listed on this page with its input parameters and its output.
Lusha connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create Subscription takes 2 required inputs: defaults and subscriptions. It also takes 1 optional input: name. It returns data, error and successful.