# Klenty

> Work with your Klenty sales engagement: add, update and look up prospects, start, stop and resume cadences, mark prospects Do Not Contact, read cadence engagement and call reports, and manage webhooks.

App · 24 actions. Web page: https://docs.lodol.com/docs/integrations/klenty

## Actions

### Add prospect

Add a prospect to Klenty, optionally into a list, with tags and custom fields. A prospect already in Klenty is not changed; use 'Update prospect' for that.

**Inputs**

- Email (`email`, text, required): The prospect's email address.
- First name (`first_name`, text): The prospect's first name.
- Last name (`last_name`, text): The prospect's last name.
- Company (`company`, text): The company they work for.
- Job title (`title`, text): Their job title.
- Phone (`phone`, text): Their phone number.
- Department (`department`, text): Their department.
- Company website (`company_domain`, text): The company's domain.
- LinkedIn URL (`linkedin_url`, text): The link to their LinkedIn profile.
- City (`city`, text): Their city.
- Country (`country`, text): Their country.
- Location (`location`, text): Their location as one line.
- List (`list_name`, text): The list to put the prospect in.
- Tags (`tags`, list): Tags to set on the prospect, one per row.
- Custom fields (`custom_fields`, object): Your own Klenty fields: each field's name with its value.
- Owner (`owner`, text): The email address of the Klenty user who owns the prospect. Leave empty to own it yourself.

**Outputs**

- `email` (text): The prospect's email address
- `success` (true/false): True once Klenty has done it

**Example output**

```json
{
  "email": "jo@example.com",
  "success": true
}
```

### Add prospects in bulk

Add up to 100 prospects at once from a list of rows, such as the rows of an earlier step. Each row needs an email and may have first_name, last_name, company, title, phone, list_name, tags, custom_fields and the other prospect fields. Says which were added and which already existed.

**Inputs**

- Prospects (`prospects`, list, required): The prospects, as a list of rows with an email each.

**Outputs**

- `added` (number): How many were added
- `already_existing` (number): How many were already in Klenty
- `count` (number): How many prospects were sent
- `results` (list): What Klenty said about each prospect
- `success` (true/false): True once Klenty has done it

**Example output**

```json
{
  "added": 1,
  "already_existing": 0,
  "count": 1,
  "results": [
    {
      "email": "jo@example.com",
      "status": "prospect added successfully"
    }
  ],
  "success": true
}
```

### Create webhook

Have Klenty send one kind of event (a reply, an open, a bounce and so on) to an https address.

**Inputs**

- Event (`event`, text, required): What makes Klenty send a notification. One of: `reply` (A prospect replies), `cadenceFirstReply` (A prospect replies for the first time in a cadence), `sendProspect` (A prospect is sent to another app), `startCadence` (A prospect starts a cadence), `completeCadence` (A prospect completes a cadence), `onMailBounce` (An email bounces), `open` (An email is opened), `click` (A link is clicked), `unsubscribe` (A prospect unsubscribes).
- Address (`url`, text, required): The https:// address Klenty sends notifications to.

**Outputs**

- `webhook` (object): The webhook

**Example output**

```json
{
  "webhook": {
    "event": "reply",
    "id": "5e9f360ec0d425001292903b",
    "url": "https://example.com/klenty"
  }
}
```

### Delete webhook

Delete a webhook so Klenty stops sending to it.

**Inputs**

- Webhook (`webhook_id`, text, required): The webhook. Pick one, or give its id from an earlier step.

**Outputs**

- `success` (true/false): True once Klenty has done it
- `webhook_id` (text): The webhook deleted

**Example output**

```json
{
  "success": true,
  "webhook_id": "5e9f360ec0d425001292903b"
}
```

### Get cadence engagement

Totals for one cadence between two days: prospects added, opens, clicks, replies, bounces and unsubscribes.

**Inputs**

- Cadence (`cadence_name`, text, required): The cadence. Pick one, or give its name from an earlier step.
- From (`start_date`, date, required): The first day to report on.
- Until (`end_date`, date, required): The last day to report on.

**Outputs**

- `engagements` (object): The cadence's totals

**Example output**

```json
{
  "engagements": {
    "bounceCount": 1,
    "inCadenceCount": 12,
    "linkCount": 4,
    "negativeCount": 1,
    "openCount": 30,
    "positiveCount": 2,
    "prospectsAdded": 20,
    "prospectsCompleted": 5,
    "replyCount": 3,
    "unsubscribeCount": 0
  }
}
```

### Get cadence engagement by step

A cadence's results step by step between two days: emails sent, opens, clicks and replies for each step.

**Inputs**

- Cadence (`cadence_name`, text, required): The cadence. Pick one, or give its name from an earlier step.
- From (`start_date`, date, required): The first day to report on.
- Until (`end_date`, date, required): The last day to report on.

**Outputs**

- `count` (number): How many steps
- `steps` (list): The cadence's steps

**Example output**

```json
{
  "count": 1,
  "steps": [
    {
      "linkCount": 3,
      "mailCount": 20,
      "negativeReply": 0,
      "openCount": 12,
      "openPercent": 60,
      "positiveReply": 1,
      "replyCount": 2,
      "replyPercent": 10,
      "stepNumber": 1,
      "stepType": "Email",
      "subject": "Hello",
      "templateName": "Intro email"
    }
  ]
}
```

### Get prospect

Get one prospect by email: name, company, list, tags and owner, and their custom fields if you ask for them.

**Inputs**

- Prospect email (`prospect_email`, text, required): The prospect's email address.
- Include custom fields (`include_custom_fields`, true/false): Also return the prospect's custom fields. Default: `false`.

**Outputs**

- `prospect` (object): The prospect

**Example output**

```json
{
  "prospect": {
    "City": "Boston",
    "Company": "Acme",
    "Country": "United States",
    "CustomFields": {
      "gender": "female"
    },
    "Email": "jo@example.com",
    "FirstName": "Jo",
    "FullName": "Jo Bloggs",
    "LastName": "Bloggs",
    "LinkedinURL": "https://www.linkedin.com/in/jo-bloggs",
    "List": "Leads",
    "Phone": "+15555555555",
    "Tags": "paid",
    "Title": "Head of Sales",
    "assignTo": "owner@example.com",
    "id": "589c78690d66820b0005ced5"
  }
}
```

### Get prospect status

Check where a prospect stands: their status and their cadence status, such as In Cadence.

**Inputs**

- Prospect email or ID (`prospect`, text, required): The prospect's email address, or their Klenty id.

**Outputs**

- `cadence_status` (text): The prospect's status in their cadence
- `prospect_status` (text): The prospect's overall status

**Example output**

```json
{
  "cadence_status": "In Cadence",
  "prospect_status": "In Cadence"
}
```

### List cadences

Get the company's cadences.

**Inputs**: None.

**Outputs**

- `cadences` (list): The cadences
- `count` (number): How many cadences

**Example output**

```json
{
  "cadences": [
    {
      "id": "5e9f2",
      "name": "Intro"
    }
  ],
  "count": 1
}
```

### List calls

Get completed calls made from Klenty between two days, which must be within the last 30 days. 200 calls a page.

**Inputs**

- From (`start_date`, date, required): The first day to include (within the last 30 days).
- Until (`end_date`, date, required): The last day to include (within the last 30 days).
- Page (`page`, number): Which page to get, starting at 0. At least 0.

**Outputs**

- `calls` (list): The calls
- `count` (number): How many calls are on this page
- `has_more` (true/false): True if another page may follow
- `next_page` (number): The page to ask for next, 0 if there is none

**Example output**

```json
{
  "calls": [
    {
      "callSid": "CA123",
      "company": "Acme",
      "disposition": "Connected",
      "duration": 120,
      "email": "jo@example.com",
      "endTime": "2026-10-20T14:02:00Z",
      "fullName": "Jo Bloggs",
      "notes": "Asked for a demo",
      "outcome": "Interested",
      "startTime": "2026-10-20T14:00:00Z",
      "status": "completed",
      "username": "owner@example.com"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_page": 0
}
```

### List lists

Get the account's prospect lists.

**Inputs**: None.

**Outputs**

- `count` (number): How many lists
- `lists` (list): The lists

**Example output**

```json
{
  "count": 1,
  "lists": [
    {
      "id": "5e9f1",
      "name": "Leads"
    }
  ]
}
```

### List prospects changed between dates

Get the prospects that were changed in Klenty between two days.

**Inputs**

- From (`start_date`, date, required): The first day to include.
- Until (`end_date`, date): The last day to include. Defaults to today.

**Outputs**

- `count` (number): How many prospects
- `prospects` (list): The prospects

**Example output**

```json
{
  "count": 1,
  "prospects": [
    {
      "City": "Boston",
      "Company": "Acme",
      "Country": "United States",
      "CustomFields": {
        "gender": "female"
      },
      "Email": "jo@example.com",
      "FirstName": "Jo",
      "FullName": "Jo Bloggs",
      "LastName": "Bloggs",
      "LinkedinURL": "https://www.linkedin.com/in/jo-bloggs",
      "List": "Leads",
      "Phone": "+15555555555",
      "Tags": "paid",
      "Title": "Head of Sales",
      "assignTo": "owner@example.com",
      "id": "589c78690d66820b0005ced5"
    }
  ]
}
```

### List prospects created between dates

Get the prospects added to Klenty between two days.

**Inputs**

- From (`start_date`, date, required): The first day to include.
- Until (`end_date`, date): The last day to include. Defaults to today.

**Outputs**

- `count` (number): How many prospects
- `prospects` (list): The prospects

**Example output**

```json
{
  "count": 1,
  "prospects": [
    {
      "City": "Boston",
      "Company": "Acme",
      "Country": "United States",
      "CustomFields": {
        "gender": "female"
      },
      "Email": "jo@example.com",
      "FirstName": "Jo",
      "FullName": "Jo Bloggs",
      "LastName": "Bloggs",
      "LinkedinURL": "https://www.linkedin.com/in/jo-bloggs",
      "List": "Leads",
      "Phone": "+15555555555",
      "Tags": "paid",
      "Title": "Head of Sales",
      "assignTo": "owner@example.com",
      "id": "589c78690d66820b0005ced5"
    }
  ]
}
```

### List prospects in a list

Get the prospects in one list, a page at a time (up to 1000 a page). To see more, run it again with the next page it gives.

**Inputs**

- List (`list_name`, text, required): The list. Pick one, or give its name from an earlier step.
- Page (`page`, number): Which page to get, starting at 1. At least 1.
- Page size (`limit`, number): How many prospects a page, 1 to 1000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many prospects are on this page
- `has_more` (true/false): True if another page may follow
- `next_page` (number): The page to ask for next, 0 if there is none
- `prospects` (list): The prospects

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "prospects": [
    {
      "City": "Boston",
      "Company": "Acme",
      "Country": "United States",
      "CustomFields": {
        "gender": "female"
      },
      "Email": "jo@example.com",
      "FirstName": "Jo",
      "FullName": "Jo Bloggs",
      "LastName": "Bloggs",
      "LinkedinURL": "https://www.linkedin.com/in/jo-bloggs",
      "List": "Leads",
      "Phone": "+15555555555",
      "Tags": "paid",
      "Title": "Head of Sales",
      "assignTo": "owner@example.com",
      "id": "589c78690d66820b0005ced5"
    }
  ]
}
```

### List webhooks

Get the account's webhooks with their events and addresses.

**Inputs**: None.

**Outputs**

- `count` (number): How many webhooks
- `webhooks` (list): The webhooks

**Example output**

```json
{
  "count": 1,
  "webhooks": [
    {
      "event": "reply",
      "id": "5e9f360ec0d425001292903b",
      "url": "https://example.com/klenty"
    }
  ]
}
```

### Mark prospect Do Not Contact

Stop all future emails to a prospect by marking them Do Not Contact. 'Revert Do Not Contact' undoes it.

**Inputs**

- Prospect email (`prospect_email`, text, required): The prospect's email address.

**Outputs**

- `email` (text): The prospect's email address
- `success` (true/false): True once Klenty has done it

**Example output**

```json
{
  "email": "jo@example.com",
  "success": true
}
```

### Remove tags from prospect

Take one or more tags off a prospect.

**Inputs**

- Prospect email (`prospect_email`, text, required): The prospect's email address.
- Tags (`tags`, list, required): The tags to remove, one per row.

**Outputs**

- `email` (text): The prospect's email address
- `success` (true/false): True once Klenty has done it

**Example output**

```json
{
  "email": "jo@example.com",
  "success": true
}
```

### Resume cadence

Resume a prospect's paused cadence.

**Inputs**

- Prospect email (`prospect_email`, text, required): The prospect's email address.

**Outputs**

- `email` (text): The prospect's email address
- `success` (true/false): True once Klenty has done it

**Example output**

```json
{
  "email": "jo@example.com",
  "success": true
}
```

### Revert Do Not Contact

Take a prospect off Do Not Contact. They go back to Not Contacted, or to Manually Stopped if they had been contacted.

**Inputs**

- Prospect email (`prospect_email`, text, required): The prospect's email address.

**Outputs**

- `email` (text): The prospect's email address
- `success` (true/false): True once Klenty has done it

**Example output**

```json
{
  "email": "jo@example.com",
  "success": true
}
```

### Start cadence

Start a cadence for a prospect who is already in Klenty.

**Inputs**

- Prospect email (`prospect_email`, text, required): The prospect's email address.
- Cadence (`cadence_name`, text, required): The cadence. Pick one, or give its name from an earlier step.

**Outputs**

- `cadence_name` (text): The cadence started
- `email` (text): The prospect's email address
- `success` (true/false): True once Klenty has done it

**Example output**

```json
{
  "cadence_name": "Intro",
  "email": "jo@example.com",
  "success": true
}
```

### Stop cadence

Take a prospect out of a cadence. Leave the cadence empty to take them out of every cadence they are in.

**Inputs**

- Prospect email (`prospect_email`, text, required): The prospect's email address.
- Cadence (`cadence_name`, text): The cadence to stop. Leave empty to stop all of them.

**Outputs**

- `cadence_name` (text): The cadence stopped, empty if all of them
- `email` (text): The prospect's email address
- `success` (true/false): True once Klenty has done it

**Example output**

```json
{
  "cadence_name": "Intro",
  "email": "jo@example.com",
  "success": true
}
```

### Stop prospect's emails

Stop the emails scheduled for a prospect.

**Inputs**

- Prospect email (`prospect_email`, text, required): The prospect's email address.

**Outputs**

- `email` (text): The prospect's email address
- `success` (true/false): True once Klenty has done it

**Example output**

```json
{
  "email": "jo@example.com",
  "success": true
}
```

### Update prospect

Change a prospect's details, list, tags, custom fields or outcome. Fields left empty stay as they are.

**Inputs**

- Prospect email (`prospect_email`, text, required): The prospect's email address.
- First name (`first_name`, text): The prospect's first name.
- Last name (`last_name`, text): The prospect's last name.
- Company (`company`, text): The company they work for.
- Job title (`title`, text): Their job title.
- Phone (`phone`, text): Their phone number.
- Department (`department`, text): Their department.
- Company website (`company_domain`, text): The company's domain.
- LinkedIn URL (`linkedin_url`, text): The link to their LinkedIn profile.
- City (`city`, text): Their city.
- Country (`country`, text): Their country.
- Location (`location`, text): Their location as one line.
- List (`list_name`, text): The list to put the prospect in.
- Tags (`tags`, list): Tags to set on the prospect, one per row.
- Custom fields (`custom_fields`, object): Your own Klenty fields: each field's name with its value.
- Outcome (`outcome`, text): The prospect's outcome, spelled exactly as in Klenty (for example Lost).

**Outputs**

- `email` (text): The prospect's email address
- `success` (true/false): True once Klenty has done it

**Example output**

```json
{
  "email": "jo@example.com",
  "success": true
}
```

### Update webhook

Change the event and address of a webhook.

**Inputs**

- Webhook (`webhook_id`, text, required): The webhook. Pick one, or give its id from an earlier step.
- Event (`event`, text, required): What makes Klenty send a notification. One of: `reply` (A prospect replies), `cadenceFirstReply` (A prospect replies for the first time in a cadence), `sendProspect` (A prospect is sent to another app), `startCadence` (A prospect starts a cadence), `completeCadence` (A prospect completes a cadence), `onMailBounce` (An email bounces), `open` (An email is opened), `click` (A link is clicked), `unsubscribe` (A prospect unsubscribes).
- Address (`url`, text, required): The https:// address Klenty sends notifications to.

**Outputs**

- `event` (text): Its event now
- `success` (true/false): True once Klenty has done it
- `url` (text): Its address now
- `webhook_id` (text): The webhook changed

**Example output**

```json
{
  "event": "open",
  "success": true,
  "url": "https://example.com/klenty",
  "webhook_id": "5e9f360ec0d425001292903b"
}
```
