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. Mail Reply
  2. Send Prospect
  3. Start Cadence
  4. Cadence Completed Without Reply
  5. Mail Bounced
  6. Mail Opened
  7. Mail Clicked
  8. Prospect Unsubscribe
  9. Email Sent

Mail 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, 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

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

SubjectLine: Welcome to Klenty

CadenceStepNumber: 1

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

Email Sent:

This event is triggered when an email is sent 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 the prospect was contacted, 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

SubjectLine: 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

Did this answer your question?