Create a lead

post

https://api.surense.com/api/v1/leads

Create a new lead.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Example:

{
    "templateId": null,
    "interestId": "63b7e678-f645-45ab-a9b8-4177282e0d8b",
    "sourceId": "adfdc074-81b3-49f7-ab71-111e43932c6d",
    "ownerId": "534a38c2-ac29-460f-9441-9fcd05d1a3cb",
    "assignedUserId": "534a38c2-ac29-460f-9441-9fcd05d1a3cb",
    "dueDate": "2025-09-15",
    "dueTime": null,
    "customerId": "9b68b34e-3185-464f-b579-894cb517b970",
    "firstName": null,
    "lastName": null,
    "idType": null,
    "idNumber": null,
    "idCardIssueDate": null,
    "phoneNumber1": null,
    "phoneNumber2": null,
    "email": null,
    "birthDate": null,
    "managerId": null
}

Body Params

Request to create a new lead

agencyId

uuid

Agency ID

externalId

string

External ID

templateId

string

Template ID

interestId

string

required

Interest ID

sourceId

string

Source ID

statusId

string

Status ID

ownerId

string

Owner ID

assignedUserId

string

Assigned user ID

leadDate

string

Lead date

dueAt

string

Due date

dueAtTimeSet

boolean

Whether due time is set

dueDate

date

deprecated

dueTime

string

deprecated

notes

string

Lead notes

customerId

string

required

Customer ID

managerId

uuid

deprecated

firstName

string

First name

lastName

string

Last name

idType

int32

enum

Identity Type:
1 - Israeli ID Card
2 - Passport
3 - Driver's License
4 - Other identity document

Allowed:

idNumber

string

Identity number

idCardIssueDate

string

ID card issue date

string

Email address

phoneNumber1

string

Phone number 1

phoneNumber2

string

Phone number 2

street

string

Street name

streetNumber

string

Street number

apartmentNumber

string

Apartment number

mailBox

int32

Mail box number

zipCode

int32

ZIP code

city

string

City

gender

int32

enum

Gender:
1 - Male
2 - Female
3 - Other

Allowed:

birthDate

string

Birth date

age

int32

Age

maritalStatus

int32

enum

Marital Status:
1 - Single
2 - Married
3 - Divorced
4 - Widowed
5 - Cohabiting

Allowed:

childCount

int32

Number of children

employerName

string

Employer name

smoker

boolean

Smoker status

monthlyIncome

int32

Monthly income

employmentStatus

int32

enum

Employment Status:
1 - Employed
2 - Unemployed
3 - Self-employed
4 - Student
5 - Retired
6 - Disabled

Allowed:

forceCreation

boolean

Force creation

customFields

array of objects

Custom fields

customFields

utmId

string

UTM ID

utmSource

string

UTM source

utmMedium

string

UTM medium

utmCampaign

string

UTM campaign

utmTerm

string

UTM term

utmContent

string

UTM content

Response

Language

Credentials

OAuth2

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

*/*

200OK