Why use Webhooks

Webhooks are a medium for apps to communicate with each other. When an event happens in Klenty, You can use a webhook to send information about that event from Klenty to the app you'd like to integrate with.

If you use Zapier, they create the webhooks necessary to send information from Klenty to another app and trigger an action. For example, you can use an event for an email sent to create a lead on your CRM.

If you're not using Zapier or the application you want to integrate with Klenty is not listed, you can use webhooks to get the two apps to talk to each other.

Setting up Webhooks with Klenty:

  1. Go to Settings → Integrations → Webhooks

  2. Select the Webhook event from the drop-down

  3. Paste the Payload URL from your app and click on Save.

What is a Payload URL?

This URL receives the webhook request from Klenty and sends a response to the client-side application.

Request type: POST

List of Webhook events available in Klenty:

  1. Cadence Completed Without Reply

  2. Email Sent

  3. Email Reply

  4. Email Bounced

  5. Email Opened

  6. Email Clicked

  7. Prospect unsubscribe

  8. Send Prospect

  9. Start Cadence

Cadence Completed without reply:

This event is triggered when a prospect completes all steps in a Cadence and hasn't replied.

Form values: returns all the fields associated with the Prospect along with list & tags the Prospect belongs to, Cadence name, Email id of the person who created the Prospect (Prospect Owner), Email id of the person who made the cadence (Cadence Owner).

Sample response:

FullName: Preena Francis

FirstName: Preena

LastName: Francis

Department: Product

Company: Klenty

CompanyDomain: klenty.com

Email: preena@klenty.com

City: Chennai

Country: India

Tags: export, test

List: LinkedIn

prospectOwner: product@klenty.com

cadenceOwner: product@klenty.com

cadenceName: Webhook

event: completeCadence

Email Sent:

This event is triggered when you send an email to the Prospect via Klenty.

Form Values: returns all the fields associated with the Prospect along with list & tags the Prospect belongs to, Cadence name through which you contacted the Prospect, Cadence Step Number, Email subject & its content in both text and HTML format along with a timestamp, Mail id of the sender, Thread id & message-id of the email.

Sample response:

FullName: Preena Francis

FirstName: Preena

LastName: Francis

Department: Product

Company: Klenty

CompanyDomain: klenty.com

Email: preena@klenty.com

City: Chennai

Country: India

Tags: export, test

List: LinkedIn

event: emailSent

cadenceName: Webhook

CadenceStepNumber: 1

subject line: Welcome to Klenty

EmailBody: Hi Preena,

I know you're busy. Just give me a 1, 2, or 3

1. We'll pass on partnering with Klenty this year. Thanks for the offer!

2. We're interested in the product, but it's not a good time. Reach back out to me in 1 month.

3. I'm interested — let's talk!

Thanks!

EmailSender: vengat@klenty.com

TimeStamp: 2021-02-15T07:14:44.083Z

ThreadId: 177861b5bc5f851e

messageId: 177861b5bc5f851e

Email Reply:

This event is triggered when a Prospect replies to an email sent from Klenty. Klenty will generate a new event for each reply.

Form Values: include all fields associated with the Prospect, Cadence Name through which you contacted the Prospect, Cadence Step Number, Email subject & its content in both text and HTML format along with a timestamp.

Sample Response:

FullName: Preena Francis

FirstName: Preena

LastName: Francis

Department: Product

Company: Klenty

CompanyDomain: klenty.com

Email: preena@klenty.com

City: Chennai

Country: India

Status: IN_CADENCE

event: reply

subject: Re: webhook test

MailContent: It works! On Thu, Jun 11, 2020 at 4:36 PM <vickram@klenty.com> wrote: > > > Hi Preena, testing our webhook events

MailHTML: <div>It works! <br /></div><br /><div><div>On Thu, Jun 11, 2020 at 4:36 PM &lt;<a href="mailto:vickram@klenty.com">vickram@klenty.com</a>&gt; wrote:<br /></div><blockquote><p> </p> <p>Hi Preena, testing our webhook events</p> <p></div>

CadenceName: Webhook

CadenceStepNumber: 1

Email bounced:

This event is triggered when an email to a prospect bounces.

Form Values: returns all the fields associated with the Prospect along with the list & tags the Prospect belongs to, Cadence name through which you contacted the Prospect, Email subject & its content in both text and HTML format along with a timestamp.

Sample response:

FullName: Preena Francis

FirstName: Preena

LastName: Francis

Department: Product

Company: Klenty

CompanyDomain: klenty.com

Email: preena@klenty.com

City: Chennai

Country: India

Tags: export, test

List: LinkedIn

prospectOwner: product@klenty.com

cadenceOwner: product@klenty.com

cadenceName: Webhook

event: onMailBounce

subject: Delivery Status Notification (Failure)

MailContent: ** Address not found ** Your message wasn't delivered to invalid@klenty.com because the Address couldn't be found or is unable to receive mail. Learn more here: https://support.google.com/mail/?p=NoSuchUser The response was: 550 5.1.1 The email account you tried to reach does not exist. Please try double-checking the recipient's email address for typos or unnecessary spaces. Learn more at https://support.google.com/mail/?p=NoSuchUser 14sor2286655qkh.100 - gsmtp

MailHTML: <table><tbody> <tr><td> <table><tbody> <tr><td> <table><tbody> <tr><td> Address not found </td></tr> <tr><td> Your message wasn't delivered to <a><b>invalid@klenty.com</b></a> because the address couldn't be found, or is unable to receive mail. </td></tr> <tr><td> <a href="https://support.google.com/mail/?p=NoSuchUser">LEARN MORE</a> </td></tr> </tbody></table> </td></tr> </tbody></table> </td></tr> <tr> <td> The response was:<br /> <p> 550 5.1.1 The email account that you tried to reach does not exist. Please try double-checking the recipient's email address for typos or unnecessary spaces. Learn more at https://support.google.com/mail/?p=NoSuchUser 14sor2286655qkh.100 - gsmtp </p> </td> </tr> </tbody></table>

CadenceName: Webhook

Email Opened:

This event is triggered when a prospect opens an email. Klenty will generate a different response for each open.

Form Values: returns all the fields associated with the Prospect along with the list & tags the Prospect belongs to, Cadence name through which you contacted the Prospect, Cadence Step Number, Email Subject, and the Prospect's current status.

Sample response:

FullName: Preena Francis

FirstName: Preena

LastName: Francis

Department: Product

Company: Klenty

CompanyDomain: klenty.com

Email: preena@klenty.com

City: Chennai

Country: India

Tags: export, test

List: LinkedIn

Status: IN_CADENCE

cadenceName: Webhook

event: open

subject line: Welcome to Klenty

CadenceStepNumber: 1

Email Clicked:

This event is triggered when a Prospect clicks on a tracked link in your email. Klenty will generate a different response for each link click.

Form Values: returns all the fields associated with the Prospect along with the list & tags the Prospect belongs to, Cadence name through which you contacted the Prospect, Prospect's current status, and the Link text along with the link URL.

Sample response:

FullName: Preena Francis

FirstName: Preena

LastName: Francis

Department: Product

Company: Klenty

CompanyDomain: klenty.com

Email: preena@klenty.com

City: Chennai

Country: India

Tags: export, test

List: LinkedIn

Status: IN_CADENCE

cadenceName: Webhook

event: click

LinkText: Click here

LinkUrl: https://klenty.com

Prospect Unsubscribe:

This event is triggered when a Prospect unsubscribes from an email sent via Klenty.

Form Values: returns all the fields associated with the Prospect along with the list & tags the Prospect belongs to and the Prospect's current status.

Sample response:

FullName: Preena Francis

FirstName: Preena

LastName: Francis

Department: Product

Company: Klenty

CompanyDomain: klenty.com

Email: preena@klenty.com

City: Chennai

Country: India

Tags: export, test

List: LinkedIn

event: unsubscribe

Status: UNSUBSCRIBED

Send Prospect:

This event is triggered when the user manually sends prospect details to Webhook from Klenty. Klenty will generate a different response for each & every prospect action.

How to Send a Prospect to Webhook:

  1. In your Klenty account, go to Prospects

  2. Click on the checkbox next to the Prospect(s) you'd like to send to the webhook

  3. Click on the More drop-down from the menu and click on Send to Webhook

Form Values: returns all fields associated with the Prospect and the list & tags the Prospect belongs to.

Sample Response:

FullName: Preena Francis

FirstName: Preena

LastName: Francis

Department: Product

Company: Klenty

CompanyDomain: klenty.com

Email: preena@klenty.com

City: Chennai

Country: India

Tags: export, test

List: LinkedIn

event: sendProspect

Start Cadence:

This event is triggered when you start a cadence for a particular Prospect or a group of Prospects. Klenty will generate a different response for each Prospect.

Form values: returns all the fields associated with the Prospect along with list & tags the Prospect belongs to, Cadence name, Email id of the person who created the Prospect (Prospect Owner), Email id of the person who made the cadence (Cadence Owner).

Sample response:

FullName: Preena Francis

FirstName: Preena

LastName: Francis

Department: Product

Company: Klenty

CompanyDomain: klenty.com

Email: preena@klenty.com

City: Chennai

Country: India

Tags: export, test

List: LinkedIn

prospectOwner: product@klenty.com

cadenceOwner: product@klenty.com

cadenceName: Webhook

event: startCadence

Did this answer your question?