Calendar

Create Calendar Event

Creates either a Task or an Appointment for the target lead, selected by the ‘type’ field (case-insensitive TASK / APPOINTMENT).

Notes:

Caller must have manage permission on the lead; otherwise 400 PERMISSION_DENIED (20017).
type, leadId, content, startAt and endAt are required. taskWay is additionally required when type = TASK.
startAt and endAt must be later than the current server time.
The returned data.id is a composite string (‘<numericId>-task’ or ‘<numericId>-appointment’) and must be used as-is when updating, finishing or deleting this entry.
When startAt and endAt are both exactly midnight (00:00:00) in their declared offsets, an appointment is automatically marked as all-day.

POST

v2.0

calendar

Create Calendar Event

curl --request POST \
  --url https://api.lofty.com/v2.0/calendar \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "type": "TASK",
  "content": "Follow up with client about property",
  "leadId": 563172647619608,
  "timeZoneCode": "America/Los_Angeles",
  "startAt": "2026-03-01T14:00:00-08:00",
  "endAt": "2026-03-01T15:00:00-08:00",
  "startAtMs": 1740866400000,
  "endAtMs": 1740870000000,
  "taskWay": "Call",
  "assignedRole": "Agent",
  "address": "123 Main St, Los Angeles, CA"
}
'

import requests

url = "https://api.lofty.com/v2.0/calendar"

payload = {
    "type": "TASK",
    "content": "Follow up with client about property",
    "leadId": 563172647619608,
    "timeZoneCode": "America/Los_Angeles",
    "startAt": "2026-03-01T14:00:00-08:00",
    "endAt": "2026-03-01T15:00:00-08:00",
    "startAtMs": 1740866400000,
    "endAtMs": 1740870000000,
    "taskWay": "Call",
    "assignedRole": "Agent",
    "address": "123 Main St, Los Angeles, CA"
}
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({
    type: 'TASK',
    content: 'Follow up with client about property',
    leadId: 563172647619608,
    timeZoneCode: 'America/Los_Angeles',
    startAt: '2026-03-01T14:00:00-08:00',
    endAt: '2026-03-01T15:00:00-08:00',
    startAtMs: 1740866400000,
    endAtMs: 1740870000000,
    taskWay: 'Call',
    assignedRole: 'Agent',
    address: '123 Main St, Los Angeles, CA'
  })
};

fetch('https://api.lofty.com/v2.0/calendar', 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/v2.0/calendar",
  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([
    'type' => 'TASK',
    'content' => 'Follow up with client about property',
    'leadId' => 563172647619608,
    'timeZoneCode' => 'America/Los_Angeles',
    'startAt' => '2026-03-01T14:00:00-08:00',
    'endAt' => '2026-03-01T15:00:00-08:00',
    'startAtMs' => 1740866400000,
    'endAtMs' => 1740870000000,
    'taskWay' => 'Call',
    'assignedRole' => 'Agent',
    'address' => '123 Main St, Los Angeles, CA'
  ]),
  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/v2.0/calendar"

	payload := strings.NewReader("{\n  \"type\": \"TASK\",\n  \"content\": \"Follow up with client about property\",\n  \"leadId\": 563172647619608,\n  \"timeZoneCode\": \"America/Los_Angeles\",\n  \"startAt\": \"2026-03-01T14:00:00-08:00\",\n  \"endAt\": \"2026-03-01T15:00:00-08:00\",\n  \"startAtMs\": 1740866400000,\n  \"endAtMs\": 1740870000000,\n  \"taskWay\": \"Call\",\n  \"assignedRole\": \"Agent\",\n  \"address\": \"123 Main St, Los Angeles, CA\"\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/v2.0/calendar")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"type\": \"TASK\",\n  \"content\": \"Follow up with client about property\",\n  \"leadId\": 563172647619608,\n  \"timeZoneCode\": \"America/Los_Angeles\",\n  \"startAt\": \"2026-03-01T14:00:00-08:00\",\n  \"endAt\": \"2026-03-01T15:00:00-08:00\",\n  \"startAtMs\": 1740866400000,\n  \"endAtMs\": 1740870000000,\n  \"taskWay\": \"Call\",\n  \"assignedRole\": \"Agent\",\n  \"address\": \"123 Main St, Los Angeles, CA\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.lofty.com/v2.0/calendar")

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  \"type\": \"TASK\",\n  \"content\": \"Follow up with client about property\",\n  \"leadId\": 563172647619608,\n  \"timeZoneCode\": \"America/Los_Angeles\",\n  \"startAt\": \"2026-03-01T14:00:00-08:00\",\n  \"endAt\": \"2026-03-01T15:00:00-08:00\",\n  \"startAtMs\": 1740866400000,\n  \"endAtMs\": 1740870000000,\n  \"taskWay\": \"Call\",\n  \"assignedRole\": \"Agent\",\n  \"address\": \"123 Main St, Los Angeles, CA\"\n}"

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

{
  "data": {
    "id": "12345-task",
    "type": "TASK",
    "message": "<string>"
  }
}

"<string>"

"<string>"

"<string>"

Headers

Authorization

string

required

Bearer [access_token]

Content-Type

string

required

application/json

Body

application/json

Calendar payload. type decides whether a Task or Appointment is created.

type

string

required

Calendar type: TASK or APPOINTMENT

Example:

"TASK"

content

string

required

Content/Description of the calendar event

Example:

"Follow up with client about property"

leadId

integer<int64>

required

Lead ID associated with this calendar event

Example:

563172647619608

timeZoneCode

string

required

Timezone code

Example:

"America/Los_Angeles"

startAt

string

Start time in ISO8601 format with timezone. Preferred over startAtMs when both are provided.

Example:

"2026-03-01T14:00:00-08:00"

endAt

string

End time in ISO8601 format. Preferred over endAtMs when both are provided.

Example:

"2026-03-01T15:00:00-08:00"

startAtMs

integer<int64>

Start time as Unix timestamp in milliseconds. Used when startAt is not provided.

Example:

1740866400000

endAtMs

integer<int64>

End time as Unix timestamp in milliseconds. Used when endAt is not provided.

Example:

1740870000000

taskWay

string

Task way type: Call, Email, Text, Other (only for TASK)

Example:

"Call"

assignedRole

string

Assigned role: Agent or Assistant (only for TASK)

Example:

"Agent"

address

string

Location/Address (only for APPOINTMENT)

Example:

"123 Main St, Los Angeles, CA"

Response

Calendar created. The response wraps CalendarCreateResult under the 'data' key.

Calendar creation response envelope

data

object

Calendar creation result

Show child attributes

Create Calendar Event

curl --request POST \
  --url https://api.lofty.com/v2.0/calendar \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "type": "TASK",
  "content": "Follow up with client about property",
  "leadId": 563172647619608,
  "timeZoneCode": "America/Los_Angeles",
  "startAt": "2026-03-01T14:00:00-08:00",
  "endAt": "2026-03-01T15:00:00-08:00",
  "startAtMs": 1740866400000,
  "endAtMs": 1740870000000,
  "taskWay": "Call",
  "assignedRole": "Agent",
  "address": "123 Main St, Los Angeles, CA"
}
'

import requests

url = "https://api.lofty.com/v2.0/calendar"

payload = {
    "type": "TASK",
    "content": "Follow up with client about property",
    "leadId": 563172647619608,
    "timeZoneCode": "America/Los_Angeles",
    "startAt": "2026-03-01T14:00:00-08:00",
    "endAt": "2026-03-01T15:00:00-08:00",
    "startAtMs": 1740866400000,
    "endAtMs": 1740870000000,
    "taskWay": "Call",
    "assignedRole": "Agent",
    "address": "123 Main St, Los Angeles, CA"
}
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({
    type: 'TASK',
    content: 'Follow up with client about property',
    leadId: 563172647619608,
    timeZoneCode: 'America/Los_Angeles',
    startAt: '2026-03-01T14:00:00-08:00',
    endAt: '2026-03-01T15:00:00-08:00',
    startAtMs: 1740866400000,
    endAtMs: 1740870000000,
    taskWay: 'Call',
    assignedRole: 'Agent',
    address: '123 Main St, Los Angeles, CA'
  })
};

fetch('https://api.lofty.com/v2.0/calendar', 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/v2.0/calendar",
  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([
    'type' => 'TASK',
    'content' => 'Follow up with client about property',
    'leadId' => 563172647619608,
    'timeZoneCode' => 'America/Los_Angeles',
    'startAt' => '2026-03-01T14:00:00-08:00',
    'endAt' => '2026-03-01T15:00:00-08:00',
    'startAtMs' => 1740866400000,
    'endAtMs' => 1740870000000,
    'taskWay' => 'Call',
    'assignedRole' => 'Agent',
    'address' => '123 Main St, Los Angeles, CA'
  ]),
  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/v2.0/calendar"

	payload := strings.NewReader("{\n  \"type\": \"TASK\",\n  \"content\": \"Follow up with client about property\",\n  \"leadId\": 563172647619608,\n  \"timeZoneCode\": \"America/Los_Angeles\",\n  \"startAt\": \"2026-03-01T14:00:00-08:00\",\n  \"endAt\": \"2026-03-01T15:00:00-08:00\",\n  \"startAtMs\": 1740866400000,\n  \"endAtMs\": 1740870000000,\n  \"taskWay\": \"Call\",\n  \"assignedRole\": \"Agent\",\n  \"address\": \"123 Main St, Los Angeles, CA\"\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/v2.0/calendar")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"type\": \"TASK\",\n  \"content\": \"Follow up with client about property\",\n  \"leadId\": 563172647619608,\n  \"timeZoneCode\": \"America/Los_Angeles\",\n  \"startAt\": \"2026-03-01T14:00:00-08:00\",\n  \"endAt\": \"2026-03-01T15:00:00-08:00\",\n  \"startAtMs\": 1740866400000,\n  \"endAtMs\": 1740870000000,\n  \"taskWay\": \"Call\",\n  \"assignedRole\": \"Agent\",\n  \"address\": \"123 Main St, Los Angeles, CA\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.lofty.com/v2.0/calendar")

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  \"type\": \"TASK\",\n  \"content\": \"Follow up with client about property\",\n  \"leadId\": 563172647619608,\n  \"timeZoneCode\": \"America/Los_Angeles\",\n  \"startAt\": \"2026-03-01T14:00:00-08:00\",\n  \"endAt\": \"2026-03-01T15:00:00-08:00\",\n  \"startAtMs\": 1740866400000,\n  \"endAtMs\": 1740870000000,\n  \"taskWay\": \"Call\",\n  \"assignedRole\": \"Agent\",\n  \"address\": \"123 Main St, Los Angeles, CA\"\n}"

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

{
  "data": {
    "id": "12345-task",
    "type": "TASK",
    "message": "<string>"
  }
}

"<string>"

"<string>"

"<string>"

Leads

Task & Calendar

Transactions

Listings

Communication

Team

AI Copilot

Webhooks

Integrations

Create Calendar Event

Headers

Body

Response