# Lusha

B2B contact enrichment and prospecting platform providing verified email addresses, phone numbers, and company information

- **Category:** sales & crm
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `LUSHA`
- **Version:** 00000000_00

## Tools

### Create Subscription

**Slug:** `LUSHA_CREATE_SUBSCRIPTION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Default subscription name prefix. |
| `defaults` | object | Yes | Default values applied to all subscriptions. Required fields: url. Optional fields: entityType, signalTypes. |
| `subscriptions` | array | Yes | Array of subscriptions to create (max 25 in production). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Subscriptions

**Slug:** `LUSHA_DELETE_SUBSCRIPTIONS`

Delete 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | array | Yes | Array of subscription IDs to delete. Maximum 25 IDs per request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Audit Logs

**Slug:** `LUSHA_GET_AUDIT_LOGS`

Retrieve 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results (1-100) |
| `offset` | integer | No | Number of results to skip |
| `status` | string ("success" | "failed" | "permanent_failure") | No | Status of audit log delivery. |
| `subscriptionId` | string | No | Filter by subscription ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Audit Log Stats

**Slug:** `LUSHA_GET_AUDIT_LOG_STATS`

Retrieve 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `subscription_id` | string | No | Filter statistics by subscription ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subscription

**Slug:** `LUSHA_GET_SUBSCRIPTION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the subscription to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Subscriptions

**Slug:** `LUSHA_LIST_SUBSCRIPTIONS`

List 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results (1-100) |
| `offset` | integer | No | Number of results to skip |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Subscription

**Slug:** `LUSHA_UPDATE_SUBSCRIPTION`

Update 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the subscription to update. |
| `url` | string | No | New webhook URL. |
| `name` | string | No | New subscription name. |
| `is_active` | boolean | No | Enable or disable subscription. |
| `signal_types` | array | No | New signal types to subscribe to. |
| `regenerate_secret` | boolean | No | Generate new webhook secret (secret will be returned in response). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |