Why use Webhooks

Webhooks are a medium for apps to communicate between each other. When an event happen in Klenty, a webhook can be used 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 Reply
  2. Send Prospect
  3. Start Cadence
  4. Cadence Completed Without Reply
  5. Mail Bounced
  6. Mail Opened
  7. Mail Clicked
  8. Prospect Unsubscribe

Cadence Reply:

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

Form Values: include all fields associated with the prospect, Cadence Name through which the prospect was contacted, 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

Send Prospect:

This event is triggered when the user manually sends prospect details to Webhook from Klenty. A separate response will be generated 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 or prospects 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 along with 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 a cadence is started for a particular prospect or a group of prospects. A separate response will be generated 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 created 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

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 created 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

Mail bounced:

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

Form Values: returns all the fields associated with the prospect along with list & tags the prospect belongs to, Cadence name through which the prospect was contacted, 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 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

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

Mail Opened:

This event is triggered when a prospect opens an email. A separate response will be generated for each open.

Form Values: returns all the fields associated with the prospect along with list & tags the prospect belongs to, Cadence name through which the prospect was contacted 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

Mail Clicked:

This event is triggered when a Prospect clicks on a tracked link in your email. A separate response will be generated for each link click.

Form Values: returns all the fields associated with the prospect along with list & tags the prospect belongs to, Cadence name through which the prospect was contacted, 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 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

Did this answer your question?