How Can We Help?
Create Lead Webhook Documentation
Kenyt.AI – Create Lead Webhook Documentation
Note: Use the POST method to pass request parameters.
authToken: It can found in dashboard in the “CRM Settings” page as “Authorization Token”
organizationId: Id of the organization.
Request:
Content-Type: application/json
Accept: application/json
*At least one of first name,last name, mobile number,email number,company are
mandatory.
|
|
|||
|---|---|---|---|
|
FirstName
|
String
|
optional
|
First Name of lead
|
|
LastName
|
String
|
optional
|
Last Name of lead
|
|
BotId
|
String
|
required
|
Id of the Bot lead is to be added to
|
|
MobileNumber
|
String
|
optional
|
Mobile Number of the lead
|
|
EmailAddress
|
String
|
optional
|
Email Address of the lead
|
|
Source
|
String
|
optional
|
Source of the lead
|
|
Company
|
String
|
optional
|
Company Name of the lead
|
|
City
|
String
|
optional
|
City of the lead
|
|
State
|
String
|
optional
|
State of the lead
|
|
Country
|
String
|
optional
|
Country of the lead
|
|
Owner
|
String
|
optional
|
Email of the Owner of the lead
|
|
CreatedBy
|
String
|
optional
|
Name of the lead’s creator
|
|
PipelineName
|
String
|
optional
|
Pipeline Name to used for the lead
|
|
PipelineStage
|
String
|
optional
|
Stage of the lead in the selected pipeline
|
|
CustomProperties
|
List of custom properties
|
optional
|
Custom fields as per the requirement
|
Sample Curl Request:
curl --location --request POST 'https://www.kenyt.ai/dashboardapi/api/crm/createlead?authToken=79e81917-bf4c-42f1-abc5-c760e2bbaa2c&organizationId=4422112' \
--header 'Content-Type: application/json' \
--data-raw '{
"FirstName":"Test Lead",
"LastName":"Last Name",
"BotId": 100,
"EmailAddress":"test220422@kenyt.com",
"MobileNumber":"7777220422",
"Source":"<Source Name>",
"Company":"<Company name>",
"City":"<City Name>",
"State":"<State Name>",
"Country":"<Country Name>",
"Owner":"<Owner'\''s Email>",
"CreatedBy":"<Creator'\''s Email/Name>",
"PipelineName":"<Lead Pipeline Name>",
"PipelineStage":"<Leas Stage>",
"CustomProperties": [
{
"Name": "<Field Name>",
"Value": "<Field Value for string type properties>",
"IValue": "<Integer Value for integer type properties>",
"DValue": "<Date Value for date type properties>"
}
]
}'
Sample Responses:
Success Response: 200 OK
{
"Id": "c077f298-2f2a-445c-bf68-69960e7d1cd2",
"Success": true,
"Message": "New Lead added succesfully"
}
{
"Id": "c077f298-2f2a-445c-bf68-69960e7d1cd2",
"Success": true,
"Message": "Lead Updated Successfully"
}
|
|
Error Responses
|
|---|---|
|
Error Code
|
Description
|
|
401
|
Authorization Failed
|
|
400
|
Bad Request (Bot Id is invalid or all of First Name, Last Name, Email Address, Mobile Number, Company fields are empty)
|
401:
{
"Id": "null",
"Success": false,
"Message": "Authorization failed"
}
400:
{
"Message": " | "
}
