Skip to main content
POST
/
api
/
{portfolio}
/
portfolios
/
v1
/
facilities
/
{facilityUuid}
/
tasks
Create a task on a facility
curl --request POST \
  --url https://public-api.prd.monument.io/api/{portfolio}/portfolios/v1/facilities/{facilityUuid}/tasks \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "name": "Follow up with tenant",
  "dueDate": "2026-06-01",
  "taskCategory": "OTHER",
  "description": "Call about overdue balance",
  "leadUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "accountUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "taskUuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Follow up with tenant",
  "description": "Call about overdue balance",
  "category": "OTHER",
  "dueDate": "2026-06-01",
  "facilityUuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "facilityName": "Downtown Storage",
  "leadUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "leadFirstName": "<string>",
  "leadLastName": "<string>",
  "tenantUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tenantFirstName": "<string>",
  "tenantLastName": "<string>",
  "completedAt": "2026-06-02T14:30:00.000Z",
  "completedByUserUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "createdAt": "2026-06-01T00:00:00.000Z"
}

Headers

​
x-api-key
any
required

Api key required to authenticate your request. Please reach out to monument for a key.

Example:

"monument-2230012-2312321"

Path Parameters

​
facilityUuid
string
required
​
portfolio
string
required

Body

application/json
​
name
string
required

Task name (max 35 characters).

Maximum string length: 35
Example:

"Follow up with tenant"

​
dueDate
string<date-time>
required

Due date. Normalized to day-only.

Example:

"2026-06-01"

​
taskCategory
enum<string>
required

Task category. Required. Determines which UUID must be present: LEADS → leadUuid; OTHER/TENANTS/DELINQUENCIES → accountUuid. The other UUID must be omitted.

Available options:
LEADS,
TENANTS,
DELINQUENCIES,
OTHER
Example:

"OTHER"

​
description
string | null

Optional task description (max 100 characters).

Maximum string length: 100
Example:

"Call about overdue balance"

​
leadUuid
string<uuid> | null

Lead to associate the task with. Required when taskCategory is LEADS; must be omitted otherwise.

​
accountUuid
string<uuid> | null

Account (tenant) to associate the task with. Required when taskCategory is OTHER, TENANTS, or DELINQUENCIES; must be omitted otherwise.

Response

Task created

​
taskUuid
string<uuid>
required

Task UUID

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

​
name
string
required

Task name

Example:

"Follow up with tenant"

​
description
string | null
required

Task description

Example:

"Call about overdue balance"

​
category
enum<string>
required

Task category

Available options:
LEADS,
TENANTS,
DELINQUENCIES,
OTHER
Example:

"OTHER"

​
dueDate
string
required

Due date (day-only)

Example:

"2026-06-01"

​
facilityUuid
string<uuid>
required

Facility UUID the task belongs to

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

​
facilityName
string | null
required

Facility name

Example:

"Downtown Storage"

​
leadUuid
string<uuid> | null
required

Associated lead UUID, if any

​
leadFirstName
string | null
required

Associated lead's first name

​
leadLastName
string | null
required

Associated lead's last name

​
tenantUuid
string<uuid> | null
required

Associated tenant (account) UUID, if any

​
tenantFirstName
string | null
required

Associated tenant's first name

​
tenantLastName
string | null
required

Associated tenant's last name

​
completedAt
string<date-time> | null
required

Completion timestamp, or null if not completed

Example:

"2026-06-02T14:30:00.000Z"

​
completedByUserUuid
string<uuid> | null
required

UUID of the user who completed the task, if any

​
createdAt
string<date-time>
required

Timestamp when the task was created

Example:

"2026-06-01T00:00:00.000Z"