LeadManaging Lead Post API Documentation

If you are hosting your own email submission form and want to send lead data directly to LeadManaging, follow the steps below:


A. API Endpoint

Send a POST request to:
https://{site}.leadmanaging.com/application/controllers/AddLead.php
 
Replace {site} with your actual LeadManaging subdomain.
 
HTTP Method: POST

B. Authentication

Type: Basic Auth

You can find these credentials in your LeadManaging UI by going to: Settings > API Documentation > Authentication

  • Username: {should be the api_user value}
  • Password: {should be the api_key value}

C. Sample JSON Payload

You’ll need to send your form data in the following JSON format (should be in Body/Raw/UTF-8 encoding)
 
{
"first_name": "tbd",
"last_name": "tbd",
"email": "tbd@tbd.tbd",
"phone": "tbd",
"building_name": "tbd",
"bedroom_type": "1 bdrm",
"inquiry_type": "email",
"media": "tbd",
"expected_move_in": "2025-12-23",
"comments": "tbd", "utm_url": "insertfullurlhere"
}
 
You'll need to send actual values for all tbd values.

D. Important Notes

  • Phone: Must contain only numeric values, 10 digits only

    • e.g., 2223334444

  • Building Name: Must exactly match what's listed in LeadManaging
  • Bedroom Type: Must exactly match one of the following and spelled exactly the same:

    • Bachelor, Junior, 1 bdrm, 1 bdrm + den, 2 bdrm, 2 bdrm + den, 3 bdrm, 4+ bdrm

  • Inquiry type: Must be spelled exactly the same

    • call, email, sms, walkin, application

  • Media: Must match the exact spelling in LeadManaging
    • To request a list of media sources, please reach out to Support Team by submitting a support ticket via support.propertyvista.com.
  • Expected Move-In Date: Format must be YYYY-MM-DD

    • e.g. 2025-12-23

  • Additional Form Fields: Include extra form fields under "comments"

    • e.g., "How Many Adults: 2"

  • UTM Source Tracking: Send the full page URL via "utm_url"

    • (e.g., "utm_url": "https://example.com/page?utm_source=google")


E. Testing with Postman (optional)

To validate before coding:

  1. Install/open Postman and create a new request
  2. Set method to POST
  3. Use the endpoint URL by replacing {site} with your actual LeadManaging subdomain
    https://{site}.leadmanaging.com/application/controllers/AddLead.php
  4. Go to the Authorization tab
    • Type: Basic Auth
    • Enter your API username and password (can be found in LeadManaging > Settings > API Documentation > Authentication)
  5. Go to the Body tab
    • Select raw and choose JSON from the dropdown
    • Paste your JSON payload
  6. Click Send
  7. You should receive a 200 OK response with Successfully Processed

Verify that your test lead is showing in LeadManaging.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request