Notifications

Send Opportunity Alert

Sends an in-app notification to the agent(s) assigned to the given lead, representing a buyer/seller activity signal (e.g. viewed a listing, saved a search, requested CMA). Certain notificationType values also trigger SMS and Email delivery.

Use case: a partner system observes a user action on its own site and wants that action to surface as an opportunity in the assigned agent’s Lofty inbox.

Delivery channels

Channel	Trigger
In-app push	All notificationType values
SMS + Email	Browse (11/48/138), Saved listing (9/52/136), Saved search (27/140), Mortgage calculator (89), Return-to-site (166)

If the lead belongs to a lead pond, the notification is broadcast to all pond members instead of the single assignee.

Important notes

The leadId must belong to the caller’s own team.
Agents whose team has the OPPORTUNITY resource disabled are silently skipped.
This endpoint is not idempotent. Repeated calls produce repeated deliveries.
The data field in the response is a best-effort success hint, not a strict delivery confirmation. See the 200 response description for details.

POST

v1.0

agent

send-notification

Send Opportunity Alert

curl --request POST \
  --url https://api.lofty.com/v1.0/agent/send-notification \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data @- <<EOF
{
  "leadId": 100001,
  "notificationType": 11,
  "description": "123 Main St, San Francisco, CA 94102",
  "link": "https://example.com/listing/123",
  "message": "I'd like to schedule a tour this weekend."
}
EOF

import requests

url = "https://api.lofty.com/v1.0/agent/send-notification"

payload = {
    "leadId": 100001,
    "notificationType": 11,
    "description": "123 Main St, San Francisco, CA 94102",
    "link": "https://example.com/listing/123",
    "message": "I'd like to schedule a tour this weekend."
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({
    leadId: 100001,
    notificationType: 11,
    description: '123 Main St, San Francisco, CA 94102',
    link: 'https://example.com/listing/123',
    message: 'I\'d like to schedule a tour this weekend.'
  })
};

fetch('https://api.lofty.com/v1.0/agent/send-notification', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lofty.com/v1.0/agent/send-notification",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'leadId' => 100001,
    'notificationType' => 11,
    'description' => '123 Main St, San Francisco, CA 94102',
    'link' => 'https://example.com/listing/123',
    'message' => 'I\'d like to schedule a tour this weekend.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lofty.com/v1.0/agent/send-notification"

	payload := strings.NewReader("{\n  \"leadId\": 100001,\n  \"notificationType\": 11,\n  \"description\": \"123 Main St, San Francisco, CA 94102\",\n  \"link\": \"https://example.com/listing/123\",\n  \"message\": \"I'd like to schedule a tour this weekend.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.lofty.com/v1.0/agent/send-notification")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"leadId\": 100001,\n  \"notificationType\": 11,\n  \"description\": \"123 Main St, San Francisco, CA 94102\",\n  \"link\": \"https://example.com/listing/123\",\n  \"message\": \"I'd like to schedule a tour this weekend.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.lofty.com/v1.0/agent/send-notification")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n  \"leadId\": 100001,\n  \"notificationType\": 11,\n  \"description\": \"123 Main St, San Francisco, CA 94102\",\n  \"link\": \"https://example.com/listing/123\",\n  \"message\": \"I'd like to schedule a tour this weekend.\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": {
    "code": 0,
    "msg": "success"
  },
  "data": true
}

"<string>"

"<string>"

Headers

Authorization

string

required

Bearer [access_token]

Content-Type

string

required

application/json

Body

application/json

leadId

integer<int64>

required

Lead ID. Must belong to the caller's team.

Example:

100001

notificationType

enum<integer>

required

Opportunity trigger type. Must match one of the supported activity codes.

Site-origin values: 9 = Saved a listing 10 = Searched 11 = Viewed a listing 27 = Saved a search 46 = Requested to sell a house 47 = Requested home evaluation 65 = Left a message 66 = Requested a showing 89 = Used mortgage calculator 162 = Requested CMA 164 = Requested financing options

NewHome-origin equivalents: 48 = Browsed a home 50 = Searched a home 52 = Favorited a home

CApp-origin equivalents: 136 = Favorited 137 = Searched 138 = Browsed 139 = Showing request 140 = Saved search 141 = House evaluation

Other: 165 = Re-inquired on text code 166 = Back to site (view a listing) 167 = Submitted a form 168 = Viewed CMA

Available options:

9,

10,

11,

27,

46,

47,

48,

50,

52,

65,

66,

89,

136,

137,

138,

139,

140,

141,

162,

164,

165,

166,

167,

168

Example:

11

description

string

Free-text description shown in the notification body. description and link form a combo; both must be non-empty for the details block to render.

Example:

"123 Main St, San Francisco, CA 94102"

link

string

Companion URL to description (see description field). Typically a listing / search / CMA URL.

Example:

"https://example.com/listing/123"

message

string

Optional free-text message. Rendered only for notificationType values that carry a leave-message context (e.g. 65); ignored by all other types.

Example:

"I'd like to schedule a tour this weekend."

Response

Request accepted. Response body = {status:{code:0,msg:"success"}, data:<bool>}. data=true => notification(s) dispatched to at least one assignee (non-pond path). data=false => one of the silent-failure conditions: leadId=0, notificationType=null, lead not found, no agent-role assignee, or the lead is a lead-pond lead (where broadcast is still triggered but the API returns false due to a known quirk). Callers SHOULD NOT rely on data=true/false as a strict delivery confirmation.

Wrapped response for POST /v1.0/agent/send-notification.

status

object

Status envelope; code=0 indicates the request was processed.

Show child attributes

data

boolean

Rough success flag. true = notification dispatched. false = silent-failure condition (missing lead, no assignee) or pond-broadcast quirk (see endpoint description). Callers should not treat this as a strict delivery confirmation.

Example:

true

Send Opportunity Alert

curl --request POST \
  --url https://api.lofty.com/v1.0/agent/send-notification \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data @- <<EOF
{
  "leadId": 100001,
  "notificationType": 11,
  "description": "123 Main St, San Francisco, CA 94102",
  "link": "https://example.com/listing/123",
  "message": "I'd like to schedule a tour this weekend."
}
EOF

import requests

url = "https://api.lofty.com/v1.0/agent/send-notification"

payload = {
    "leadId": 100001,
    "notificationType": 11,
    "description": "123 Main St, San Francisco, CA 94102",
    "link": "https://example.com/listing/123",
    "message": "I'd like to schedule a tour this weekend."
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({
    leadId: 100001,
    notificationType: 11,
    description: '123 Main St, San Francisco, CA 94102',
    link: 'https://example.com/listing/123',
    message: 'I\'d like to schedule a tour this weekend.'
  })
};

fetch('https://api.lofty.com/v1.0/agent/send-notification', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lofty.com/v1.0/agent/send-notification",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'leadId' => 100001,
    'notificationType' => 11,
    'description' => '123 Main St, San Francisco, CA 94102',
    'link' => 'https://example.com/listing/123',
    'message' => 'I\'d like to schedule a tour this weekend.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lofty.com/v1.0/agent/send-notification"

	payload := strings.NewReader("{\n  \"leadId\": 100001,\n  \"notificationType\": 11,\n  \"description\": \"123 Main St, San Francisco, CA 94102\",\n  \"link\": \"https://example.com/listing/123\",\n  \"message\": \"I'd like to schedule a tour this weekend.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.lofty.com/v1.0/agent/send-notification")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"leadId\": 100001,\n  \"notificationType\": 11,\n  \"description\": \"123 Main St, San Francisco, CA 94102\",\n  \"link\": \"https://example.com/listing/123\",\n  \"message\": \"I'd like to schedule a tour this weekend.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.lofty.com/v1.0/agent/send-notification")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n  \"leadId\": 100001,\n  \"notificationType\": 11,\n  \"description\": \"123 Main St, San Francisco, CA 94102\",\n  \"link\": \"https://example.com/listing/123\",\n  \"message\": \"I'd like to schedule a tour this weekend.\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": {
    "code": 0,
    "msg": "success"
  },
  "data": true
}

"<string>"

"<string>"

Leads

Task & Calendar

Transactions

Listings

Communication

Team

AI Copilot

Webhooks

Integrations

Send Opportunity Alert

Delivery channels

Important notes

Headers

Body

Response