Leads

GET

Retrieves all leads for the authenticated user's team.

get

Responses

200

Leads retrieved successfully

application/json

countnumberOptionalExample: 10

403

Access denied

application/json

get

/leads

GET /leads HTTP/1.1
Accept: */*

{
  "count": 10,
  "leads": [
    {
      "id": 1,
      "firstName": "John",
      "lastName": "Doe",
      "email": "john.doe@example.com",
      "phoneNumber": [
        "123-456-7890"
      ],
      "status": "New",
      "business": [
        {
          "id": 1,
          "name": "Business Name"
        }
      ]
    }
  ]
}

Searches for leads based on the provided search term.

get

Responses

200

Leads retrieved successfully

application/json

idnumberOptionalExample: 1

firstNamestringOptionalExample: John

lastNamestringOptionalExample: Doe

emailstringOptionalExample: john.doe@example.com

phoneNumberstring[]OptionalExample: ["123-456-7890"]

statusstringOptionalExample: New

403

Access denied

application/json

get

/leads/search

GET /leads/search HTTP/1.1
Accept: */*

[
  {
    "id": 1,
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "phoneNumber": [
      "123-456-7890"
    ],
    "status": "New",
    "business": [
      {
        "id": 1,
        "name": "Business Name"
      }
    ]
  }
]

Retrieves a lead by its ID.

get

Path parameters

idstringRequired

Responses

200

Lead retrieved successfully

application/json

idnumberOptionalExample: 1

firstNamestringOptionalExample: John

lastNamestringOptionalExample: Doe

emailstringOptionalExample: john.doe@example.com

phoneNumberstring[]OptionalExample: ["123-456-7890"]

statusstringOptionalExample: New

403

Access denied

application/json

404

Lead not found

application/json

get

/leads/{id}

GET /leads/{id} HTTP/1.1
Accept: */*

{
  "id": 1,
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "phoneNumber": [
    "123-456-7890"
  ],
  "status": "New",
  "business": [
    {
      "id": 1,
      "name": "Business Name"
    }
  ]
}

Retrieves lead statuses for the authenticated user's team.

get

Responses

200

Lead statuses retrieved successfully

application/json

colorsstring[]OptionalExample: blue

403

Access denied

application/json

get

/leads/statuses

GET /leads/statuses HTTP/1.1
Accept: */*

{
  "statuses": [
    {
      "id": 1,
      "name": "New",
      "primaryColor": "blue",
      "secondaryColor": "lightblue"
    }
  ],
  "colors": [
    "blue"
  ]
}

Retrieves the volume of leads per business per day.

get

Responses

200

Leads volume retrieved successfully

application/json

labelsstring[]OptionalExample: ["2023-01-01","2023-01-02"]

totalLeadsAmountnumberOptionalExample: 100

percentageChangenumberOptionalExample: 10

403

Access denied

application/json

get

/leads/leads-volume

GET /leads/leads-volume HTTP/1.1
Accept: */*

{
  "labels": [
    "2023-01-01",
    "2023-01-02"
  ],
  "data": {
    "ANY_ADDITIONAL_PROPERTY": {
      "ANY_ADDITIONAL_PROPERTY": 10
    }
  },
  "totalLeadsAmount": 100,
  "percentageChange": 10
}

Counts the total number of leads over a specified period.

get

Responses

200

Total leads counted successfully

application/json

namestringOptionalExample: New

currentnumberOptionalExample: 10

percentageChangenumberOptionalExample: 10

colorstringOptionalExample: blue

backgroundColorstringOptionalExample: lightblue

403

Access denied

application/json

get

/leads/total-leads

GET /leads/total-leads HTTP/1.1
Accept: */*

{
  "name": "New",
  "current": 10,
  "percentageChange": 10,
  "color": "blue",
  "backgroundColor": "lightblue"
}

Finds the five most recent leads over a specified period.

get

Responses

200

Recent leads found successfully

application/json

idnumberOptionalExample: 1

firstNamestringOptionalExample: John

lastNamestringOptionalExample: Doe

emailstringOptionalExample: john.doe@example.com

phoneNumberstring[]OptionalExample: ["123-456-7890"]

statusstringOptionalExample: New

403

Access denied

application/json

get

/leads/recent-leads

GET /leads/recent-leads HTTP/1.1
Accept: */*

[
  {
    "id": 1,
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "phoneNumber": [
      "123-456-7890"
    ],
    "status": "New",
    "business": [
      {
        "id": 1,
        "name": "Business Name"
      }
    ]
  }
]

Retrieves the number of leads per business over a specified period.

get

Responses

200

Leads per business retrieved successfully

application/json

Other propertiesnumberOptionalExample: 10

403

Access denied

application/json

get

/leads/leads-per-business

GET /leads/leads-per-business HTTP/1.1
Accept: */*

{
  "ANY_ADDITIONAL_PROPERTY": 10
}

Retrieves a photo for a lead by its file name.

get

Path parameters

fileNamestringRequired

Responses

200

Photo retrieved successfully

application/json

string · binaryOptional

404

Photo not found

application/json

get

/leads/get-photo/{fileName}

GET /leads/get-photo/{fileName} HTTP/1.1
Accept: */*

binary

Retrieves logs for a lead by its ID.

get

Path parameters

idnumberRequired

Responses

200

Logs retrieved successfully

application/json

countnumberOptionalExample: 5

400

Invalid lead ID

application/json

403

Access denied

application/json

404

Lead not found

application/json

get

/leads/logs/{id}

GET /leads/logs/{id} HTTP/1.1
Accept: */*

{
  "count": 5,
  "logs": [
    {
      "id": 1,
      "action": "CreateLead",
      "entityType": "Lead",
      "user": {
        "id": 1,
        "email": "user@example.com"
      },
      "createdAt": "2023-01-01T00:00:00Z"
    }
  ]
}

Retrieves logs and comments for a lead by its ID.

get

Path parameters

idnumberRequired

Responses

200

Logs and comments retrieved successfully

application/json

logsCountnumberOptionalExample: 5

commentsCountnumberOptionalExample: 5

400

Invalid lead ID

application/json

403

Access denied

application/json

404

Lead not found

application/json

get

/leads/logs-and-comments/{id}

GET /leads/logs-and-comments/{id} HTTP/1.1
Accept: */*

{
  "logsAndComments": [
    {
      "id": 1,
      "action": "CreateLead",
      "entityType": "Lead",
      "user": {
        "id": 1,
        "email": "user@example.com"
      },
      "content": "This is a comment.",
      "createdAt": "2023-01-01T00:00:00Z"
    }
  ],
  "logsCount": 5,
  "commentsCount": 5
}

POST

Creates a new lead.

post

Body

firstNamestringRequiredExample: John

lastNamestringRequiredExample: Doe

businessnumber[]RequiredExample: [1,2,3]

photostringRequiredExample: photo.jpg

statestring · enumRequiredExample: ActivePossible values:

statusIdnumberRequiredExample: 1

sourcestringRequiredExample: Referral

phoneNumberstring[]RequiredExample: ["123-456-7890"]

emailstringRequiredExample: john.doe@example.com

descriptionstringRequiredExample: Lead description

locationstringRequiredExample: New York

positionstringRequiredExample: Manager

companystringRequiredExample: Company Name

Responses

201

Lead created successfully

application/json

400

Email already exists

application/json

404

No lead status found

application/json

500

Internal server error

application/json

post

/leads

POST /leads HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 427

{
  "firstName": "John",
  "lastName": "Doe",
  "business": [
    1,
    2,
    3
  ],
  "photo": "photo.jpg",
  "state": "Active",
  "statusId": 1,
  "source": "Referral",
  "phoneNumber": [
    "123-456-7890"
  ],
  "email": "john.doe@example.com",
  "description": "Lead description",
  "location": "New York",
  "socialMedia": {
    "youtube": "youtube.com/lead",
    "facebook": "facebook.com/lead",
    "instagram": "instagram.com/lead",
    "twitter": "twitter.com/lead"
  },
  "position": "Manager",
  "company": "Company Name"
}

{
  "id": 1,
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "phoneNumber": [
    "123-456-7890"
  ],
  "status": "New",
  "business": [
    {
      "id": 1,
      "name": "Business Name"
    }
  ]
}

Creates a new lead status for the authenticated user's team.

post

Body

namestringRequiredExample: New

primaryColorstring · enumRequiredExample: bluePossible values:

Responses

201

Lead status created successfully

application/json

400

Lead status already exists

application/json

500

Internal server error

application/json

post

/leads/status

POST /leads/status HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "name": "New",
  "primaryColor": "blue"
}

{
  "id": 1,
  "name": "New",
  "primaryColor": "blue",
  "secondaryColor": "lightblue"
}

Uploads a photo for a lead.

post

Body

idnumberOptionalExample: 1

photostring · binaryOptional

Responses

200

Photo uploaded successfully

application/json

stringOptionalExample: formatted_file_name.jpg

400

Invalid file

application/json

403

Access denied

application/json

post

/leads/upload-photo

POST /leads/upload-photo HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "id": 1,
  "photo": "binary"
}

formatted_file_name.jpg

Leaves a comment on a lead.

post

Path parameters

idnumberRequired

Body

contentstringOptionalExample: This is a comment.

Responses

201

Comment added successfully

application/json

400

Invalid lead ID

application/json

403

Access denied

application/json

404

Lead not found

application/json

post

/leads/comments/{id}

POST /leads/comments/{id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "content": "This is a comment."
}

{
  "id": 1,
  "content": "This is a comment.",
  "user": {
    "id": 1,
    "firstName": "John",
    "lastName": "Doe",
    "email": "user@example.com"
  },
  "createdAt": "2023-01-01T00:00:00Z"
}

PATCH

Archives multiple leads.

patch

Body

idsnumber[]OptionalExample: [1,2,3]

Responses

200

Leads archived successfully

application/json

anyOptionalExample: {"message":"Leads archived successfully","description":"The leads have been archived successfully."}

400

One or more leads not found

application/json

403

Access denied

application/json

500

Internal server error

application/json

patch

/leads/archive

PATCH /leads/archive HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "ids": [
    1,
    2,
    3
  ]
}

{
  "message": "Leads archived successfully",
  "description": "The leads have been archived successfully."
}

Restores multiple archived leads.

patch

Body

idsnumber[]OptionalExample: [1,2,3]

Responses

200

Leads restored successfully

application/json

anyOptionalExample: {"message":"Leads restored successfully","description":"The leads have been restored successfully."}

400

One or more leads not found

application/json

403

Access denied

application/json

500

Internal server error

application/json

patch

/leads/restore

PATCH /leads/restore HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "ids": [
    1,
    2,
    3
  ]
}

{
  "message": "Leads restored successfully",
  "description": "The leads have been restored successfully."
}

PUT

Updates a lead by its ID.

put

Path parameters

idstringRequired

Body

firstNamestring · nullableRequiredExample: John

lastNamestring · nullableRequiredExample: Doe

businessnumber[]RequiredExample: [1,2,3]

photostring · nullableRequiredExample: photo.jpg

statestring · enum · nullableRequiredExample: ActivePossible values:

statusIdnumber · nullableRequiredExample: 1

sourcestring · nullableRequiredExample: Referral

phoneNumberstring[] · nullableRequiredExample: ["123-456-7890"]

emailstring · nullableOptionalExample: john.doe@example.com

descriptionstring · nullableRequiredExample: Lead description

locationstring · nullableRequiredExample: New York

positionstring · nullableRequiredExample: Manager

companystring · nullableRequiredExample: Company Name

Responses

200

Lead updated successfully

application/json

idnumberOptionalExample: 1

firstNamestringOptionalExample: John

lastNamestringOptionalExample: Doe

emailstringOptionalExample: john.doe@example.com

phoneNumberstring[]OptionalExample: ["123-456-7890"]

statusstringOptionalExample: Updated Status

400

Invalid lead data

application/json

403

Access denied

application/json

404

Lead not found

application/json

put

/leads/{id}

PUT /leads/{id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 427

{
  "firstName": "John",
  "lastName": "Doe",
  "business": [
    1,
    2,
    3
  ],
  "photo": "photo.jpg",
  "state": "Active",
  "statusId": 1,
  "source": "Referral",
  "phoneNumber": [
    "123-456-7890"
  ],
  "email": "john.doe@example.com",
  "description": "Lead description",
  "location": "New York",
  "socialMedia": {
    "youtube": "youtube.com/lead",
    "facebook": "facebook.com/lead",
    "instagram": "instagram.com/lead",
    "twitter": "twitter.com/lead"
  },
  "position": "Manager",
  "company": "Company Name"
}

{
  "id": 1,
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "phoneNumber": [
    "123-456-7890"
  ],
  "status": "Updated Status",
  "business": [
    {
      "id": 1,
      "name": "Business Name"
    }
  ]
}

Changes the status of multiple leads.

put

Body

idsnumber[]RequiredExample: [1,2,3]

statusIdnumberRequiredExample: 1

Responses

200

Lead statuses updated successfully

application/json

idnumberOptionalExample: 1

statusstringOptionalExample: Updated Status

400

Invalid status ID

application/json

403

Access denied

application/json

404

Lead not found

application/json

put

/leads/change-status

PUT /leads/change-status HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "ids": [
    1,
    2,
    3
  ],
  "statusId": 1
}

[
  {
    "id": 1,
    "status": "Updated Status"
  }
]

Updates a lead status by its ID.

put

Path parameters

idstringRequired

Body

namestring · nullableRequiredExample: New

primaryColorstring · enum · nullableRequiredExample: bluePossible values:

Responses

200

Lead status updated successfully

application/json

idnumberOptionalExample: 1

namestringOptionalExample: Updated Status

primaryColorstringOptionalExample: green

secondaryColorstringOptionalExample: lightgreen

400

Lead status not found

application/json

500

Internal server error

application/json

put

/leads/status/{id}

PUT /leads/status/{id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "name": "New",
  "primaryColor": "blue"
}

{
  "id": 1,
  "name": "Updated Status",
  "primaryColor": "green",
  "secondaryColor": "lightgreen"
}

Updates the order of lead statuses.

put

Bodyobject[]

idnumberOptionalExample: 1

statusOrdernumberOptionalExample: 1

Responses

200

Lead statuses order updated successfully

application/json

idnumberOptionalExample: 1

statusOrdernumberOptionalExample: 1

500

Internal server error

application/json

put

/leads/statuses/order

PUT /leads/statuses/order HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "id": 1,
  "statusOrder": 1
}

[
  {
    "id": 1,
    "statusOrder": 1
  }
]

Edits a comment on a lead.

put

Path parameters

idnumberRequired

Body

contentstringOptionalExample: This is an edited comment.

Responses

200

Comment edited successfully

application/json

idnumberOptionalExample: 1

contentstringOptionalExample: This is an edited comment.

createdAtstring · date-timeOptionalExample: 2023-01-01T00:00:00Z

400

Invalid comment ID

application/json

403

Access denied

application/json

404

Comment not found

application/json

put

/leads/comments/{id}

PUT /leads/comments/{id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "content": "This is an edited comment."
}

{
  "id": 1,
  "content": "This is an edited comment.",
  "user": {
    "id": 1,
    "firstName": "John",
    "lastName": "Doe",
    "email": "user@example.com"
  },
  "createdAt": "2023-01-01T00:00:00Z"
}

DELETE

Deletes multiple leads.

delete

Body

idsnumber[]OptionalExample: [1,2,3]

Responses

200

Leads deleted successfully

application/json

anyOptionalExample: {"message":"Leads deleted successfully","description":"The leads have been deleted successfully."}

400

One or more leads not found

application/json

403

Access denied

application/json

500

Internal server error

application/json

delete

/leads

DELETE /leads HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "ids": [
    1,
    2,
    3
  ]
}

{
  "message": "Leads deleted successfully",
  "description": "The leads have been deleted successfully."
}

Deletes a photo for a lead by its file name.

delete

Path parameters

fileNamestringRequired

Responses

200

Photo deleted successfully

application/json

anyOptionalExample: {"message":"Photo deleted successfully","description":"The photo has been deleted successfully."}

404

Lead not found

application/json

delete

/leads/delete-photo/{fileName}

DELETE /leads/delete-photo/{fileName} HTTP/1.1
Accept: */*

{
  "message": "Photo deleted successfully",
  "description": "The photo has been deleted successfully."
}

Deletes a lead status by its ID.

delete

Path parameters

idstringRequired

Responses

200

Lead status deleted successfully

application/json

anyOptionalExample: {"message":"Lead status deleted successfully","description":"The lead status has been deleted successfully."}

400

Cannot delete status

application/json

500

Internal server error

application/json

delete

/leads/status/{id}

DELETE /leads/status/{id} HTTP/1.1
Accept: */*

{
  "message": "Lead status deleted successfully",
  "description": "The lead status has been deleted successfully."
}

PreviousFiles Demo NextOrders

Last updated 1 year ago

hashtagGET

hashtagRetrieves all leads for the authenticated user's team.

hashtagSearches for leads based on the provided search term.

hashtagRetrieves a lead by its ID.

hashtagRetrieves lead statuses for the authenticated user's team.

hashtagRetrieves the volume of leads per business per day.

hashtagCounts the total number of leads over a specified period.

hashtagFinds the five most recent leads over a specified period.

hashtagRetrieves the number of leads per business over a specified period.

hashtagRetrieves a photo for a lead by its file name.

hashtagRetrieves logs for a lead by its ID.

hashtagRetrieves logs and comments for a lead by its ID.

hashtagPOST

hashtagCreates a new lead.

hashtagCreates a new lead status for the authenticated user's team.

hashtagUploads a photo for a lead.

hashtagLeaves a comment on a lead.

hashtagPATCH

hashtagArchives multiple leads.

hashtagRestores multiple archived leads.

hashtagPUT

hashtagUpdates a lead by its ID.

hashtagChanges the status of multiple leads.

hashtagUpdates a lead status by its ID.

hashtagUpdates the order of lead statuses.

hashtagEdits a comment on a lead.

hashtagDELETE

hashtagDeletes multiple leads.

hashtagDeletes a photo for a lead by its file name.

hashtagDeletes a lead status by its ID.

GET

Retrieves all leads for the authenticated user's team.

Searches for leads based on the provided search term.

Retrieves a lead by its ID.

Retrieves lead statuses for the authenticated user's team.

Retrieves the volume of leads per business per day.

Counts the total number of leads over a specified period.

Finds the five most recent leads over a specified period.

Retrieves the number of leads per business over a specified period.

Retrieves a photo for a lead by its file name.

Retrieves logs for a lead by its ID.

Retrieves logs and comments for a lead by its ID.

POST

Creates a new lead.

Creates a new lead status for the authenticated user's team.

Uploads a photo for a lead.

Leaves a comment on a lead.

PATCH

Archives multiple leads.

Restores multiple archived leads.

PUT

Updates a lead by its ID.

Changes the status of multiple leads.

Updates a lead status by its ID.

Updates the order of lead statuses.

Edits a comment on a lead.

DELETE

Deletes multiple leads.

Deletes a photo for a lead by its file name.

Deletes a lead status by its ID.