Documentation | API Reference

Feature Overview

The contract negotiation feature allows you to send a draft Lease Agreement to potential tenants for review and to receive their approval or objections. This simplifies the pre-contract negotiation process.

Key Features

Automatic email sending with contract to recipient
PDF attachment with full contract text
Option to hide tenant details in document
Status tracking: sent, viewed, approved, rejected
Receiving comments and objections from potential tenants
Automatic notification to landlord about response

Access Permissions

The contract negotiation feature is only available to property owners and their agents.

Role	Send	View List	Delete
Landlord	Yes	Yes	Yes
Landlord Agent	Yes	Yes	Yes
Tenant	No	No	No

How to Send a Contract for Approval

1

Open Property Page

Navigate to the property page for which you want to send the contract.

2

Click Negotiation Button

Click the handshake icon next to the property name to open the sending form.

3

Fill Recipient Details

Enter the name and email of the potential tenant, select the document language.

4

Select Contract

Select an existing contract or create a new one by configuring condition blocks.

5

Send for Approval

Click the "Send" button. An email will be sent to the specified address.

Contract Options

Existing Contract

Select a previously created contract from the list. All conditions are already configured.

New Contract

Create a new contract by configuring condition blocks directly in the negotiation form.

"Without Details" Option

Enable this option to hide tenant personal data in the PDF document. This is useful for protecting privacy during negotiations.

Negotiation Statuses

Each negotiation has a status that reflects the current state of negotiations.

Sent

Email sent, awaiting review

Viewed

Recipient opened the link

Approved

Contract approved by recipient

Rejected

Contract rejected with comment

Expired

Link validity period expired

How It Works for Recipient

The potential tenant receives an email with a link to view the contract.

1

Opening the Link

Recipient follows the link from the email and sees a page with the contract and PDF download button.

2

Reviewing the Contract

Recipient downloads the PDF and studies the Lease Agreement terms.

3

Sending Response

Recipient clicks "Approve" or "Reject" and can add a comment with their remarks.

Landlord Notification

Immediately after the recipient responds, the landlord receives an email notification with the negotiation result, comment, and recommendations for next steps.

Viewing Results

All sent negotiations and their results are available in the property negotiations list.

Column	Description
Recipient	Name and email of contract recipient
Contracts	Link to associated contract
Sent At	Date and time of email sending
Status	Current negotiation status (sent, viewed, approved, rejected)
Response	Comment or objection from recipient

API for Integrations

REST API is available for automating work with negotiations.

Service layer note

Available Endpoints

GET    /api/v1/properties/{id}/negotiations           # Get negotiations list
POST   /api/v1/properties/{id}/negotiations           # Create and send negotiation
GET    /api/v1/properties/{id}/negotiations/{nid}     # Get negotiation details
DELETE /api/v1/properties/{id}/negotiations/{nid}     # Delete negotiation
POST   /api/v1/properties/{id}/negotiations/{nid}/resend # Resend email

Request Example

POST request body for creating negotiation

{
  "recipient_email": "[email protected]",
  "recipient_name": "John Doe",
  "locale": "uk",
  "hide_requisites": true,
  "expires_in_days": 14,
  "contract_type": "existing",
  "contract_id": 5
}

Full API documentation is available in Swagger:

Open API Documentation

Contract Negotiations