TenantCloud

Supergood | TenantCloud API

Alex Klarfeld

Alex Klarfeld

— 6 min read

Programmatically access TenantCloud property portfolios, units, tenants, leases, rent payments, maintenance tickets, and applications with a stable REST API. Supergood builds and operates production-grade, unofficial TenantCloud integrations so your team can automate landlord and property management workflows without heavy custom engineering.

Plain English: TenantCloud is property management software for landlords and small to mid-sized property managers to manage rentals end-to-end—listings, applications, tenant screening, e‑sign leases, online rent collection, accounting, maintenance, and tenant communications. An unofficial API lets you programmatically pull properties, units, tenants, leases, payments, maintenance requests, and applications—and push new records or updates back into TenantCloud (e.g., create leases, update maintenance statuses, post rent adjustments).

For a tech company integrating with TenantCloud, this means you can ingest real-time portfolio and tenant data to power dashboards, reconcile payments to accounting (e.g., QuickBooks, Xero), automate lease creation and e‑signature invites from your product, streamline maintenance dispatch with vendors, or enrich your platform with applications, screening statuses, and documents. You can also trigger rent reminders, manage move‑ins/outs, sync balances to your CRM/ERP, and keep stakeholder systems (analytics, accounting, customer support) in lockstep.

What is TenantCloud?

TenantCloud (https://www.tenantcloud.com/) is a cloud platform for residential property management that centralizes rentals, tenant lifecycle, accounting, and maintenance operations across landlords, property managers, tenants, and service vendors. Teams use TenantCloud to list properties, collect rental applications and run screenings, generate and e‑sign leases, collect rent online, track expenses and income, handle maintenance tickets, and share statements with owners and tenants via portals.

Core product areas include:

  • Portfolio & Unit Management (Properties, Units, Amenities, Market Rent, Availability)
  • Tenant & Leasing (Applications, Screening, Leases, Co‑tenants/Roommates, Notices)
  • Payments & Accounting (Online Rent Collection, Fees, Deposits, Refunds, Invoices, Reports)
  • Maintenance & Vendors (Work Orders, Assignments, Scheduling, Costs, Photos/Documents)
  • Communication & Portals (Tenant Portal, Messages, Notifications, E‑Signatures)

Common data entities:

  • Users & Roles (Landlord/Manager, Tenant, Owner, Vendor/Contractor)
  • Properties (metadata, address, property type, unit count)
  • Units (bed/bath, rent, status, availability, pet policy)
  • Tenants (contacts, portal status, balance, preferences)
  • Applications (applicant details, screening status, documents)
  • Leases (terms, rent/deposit, due day, fees, signatures, status)
  • Payments (transactions, methods, fees, net, settlement status)
  • Maintenance Requests (category, priority, assignment, status, costs)
  • Documents (leases, receipts, photos, statements)

The TenantCloud Integration Challenge

Property teams rely on TenantCloud daily, but turning portal-based workflows into API-driven automation is non-trivial:

  • Portal-first features: Applications, screenings, e‑sign, and maintenance flows are optimized for UI/portal interactions rather than headless automation
  • Role-aware data: Landlords, tenants, owners, and vendors see different objects and approval states that must be respected programmatically
  • Payment reconciliation: Transaction fees, settlements, refunds, and chargebacks require careful mapping to accounting systems
  • Attachments & exports: Teams often report limitations around exporting full‑fidelity data, attachments, and historical records across modules
  • Authentication complexity: SSO/MFA and session lifecycles complicate unattended integrations
  • Limited official API: Many customers note the lack of a documented public API, making automation and data sync difficult without reverse‑engineering

How Supergood Creates TenantCloud APIs

Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your TenantCloud account.

  • Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
  • Maintains session continuity with automated refresh and change detection
  • Normalizes responses so you can integrate once and rely on consistent objects across modules
  • Aligns with customer entitlements and role-based permissions to ensure compliant access

Use Cases

Portfolio & Tenant Data Sync

  • Mirror properties, units, and tenants into your internal systems
  • Keep availability, market rent, and occupancy current for analytics and reporting
  • Normalize addresses, statuses, and lease identifiers for multi-portfolio operations

Lease & Payment Automation

  • Create leases with terms, fees, and deposit rules from your product
  • Trigger tenant e‑signature invites and track signatures and countersignatures
  • Pull payment status and amounts to reconcile with ERP/accounting (e.g., QuickBooks, Xero)

Maintenance & Vendor Operations

  • Ingest maintenance requests with photos and notes to drive dispatch workflows
  • Assign vendors, schedule service, and update statuses programmatically
  • Track costs and integrate with payables or owner statements

Listings & Applications Intake

  • Sync applications and screening status for faster approvals
  • Attach documents and move applicants into leasing flows automatically
  • Maintain audit trails and status transitions across your CRM and TenantCloud

Available Endpoints

Authentication

POST /sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/sessions \
  --header 'Authorization: Basic <Base64 encoded token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "[email protected]",
    "password": "<password>",
    "mfa": { "type": "totp", "code": "123456" }
  }'

Example response

{
  "authToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "user": {
    "id": "u_tc_91ab30",
    "name": "Property Manager",
    "entitlements": ["properties", "units", "tenants", "leases", "payments", "maintenance"]
  }
}

POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.

Properties

GET /properties: List properties with summary details and unit counts.

Query parameters

  • ownerId: string
  • city: string
  • status: active | archived | draft
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "propertyId": "prop_7f41c2",
      "name": "Maple Grove Apartments",
      "type": "multifamily",
      "status": "active",
      "address": {
        "line1": "412 Maple Grove Ln",
        "city": "Austin",
        "region": "TX",
        "postalCode": "78704",
        "country": "US"
      },
      "unitSummary": {
        "totalUnits": 24,
        "occupiedUnits": 22,
        "vacantUnits": 2,
        "marketRentTotal": 38250.00
      },
      "defaultDueDay": 1,
      "lateFeePolicy": { "type": "percent", "value": 5.0, "graceDays": 3 },
      "updatedAt": "2026-01-20T13:45:00Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Leases

POST /leases: Create a lease with terms, fees, and e‑signature invite options.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/leases \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "unitId": "unit_apt_12b",
    "tenantIds": ["ten_4aa921", "ten_4aa922"],
    "startDate": "2026-02-01",
    "endDate": "2027-01-31",
    "rentAmount": 1850.00,
    "currency": "USD",
    "depositAmount": 1850.00,
    "dueDay": 1,
    "lateFee": { "type": "flat", "amount": 75.00, "graceDays": 3 },
    "autopayEnabled": true,
    "notes": "No smoking. Pets allowed with monthly fee.",
    "attachments": [
      {"fileName": "pet_addendum.pdf", "uploadToken": "upl_18ac12"}
    ],
    "sendSignatureInvites": true
  }'

Example response

{
  "leaseId": "lease_5e9110",
  "status": "pending_signature",
  "unitId": "unit_apt_12b",
  "tenantCount": 2,
  "createdAt": "2026-01-21T10:03:11Z"
}

Payments

GET /payments: List rent payment transactions with settlement and fee details.

Query parameters

  • leaseId: string
  • tenantId: string
  • status: pending | settled | failed | refunded
  • dateFrom, dateTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "paymentId": "pay_91cd20",
      "leaseId": "lease_5e9110",
      "tenantId": "ten_4aa921",
      "amount": 1850.00,
      "currency": "USD",
      "method": "ach",
      "processorFee": 2.95,
      "netAmount": 1847.05,
      "postedAt": "2026-02-01T09:15:00Z",
      "status": "settled",
      "reference": "FEB-2026-RENT",
      "receiptUrl": "https://files.tenantcloud.com/receipts/pay_91cd20.pdf"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Maintenance Requests

PATCH /maintenance-requests/{requestId}: Update request status, vendor assignment, and scheduling.

curl --request PATCH \
  --url https://api.supergood.ai/integrations/<integration_id>/maintenance-requests/mr_3b8c21 \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "status": "in_progress",
    "assignedVendorId": "ven_9d1140",
    "scheduledDate": "2026-02-03",
    "priority": "high",
    "costEstimate": 225.00,
    "notes": "Leak under kitchen sink; parts on order."
  }'

Example response

{
  "requestId": "mr_3b8c21",
  "unitId": "unit_apt_12b",
  "category": "plumbing",
  "status": "in_progress",
  "assignedVendorId": "ven_9d1140",
  "scheduledDate": "2026-02-03",
  "updatedAt": "2026-01-22T08:15:12Z"
}

Get full API Specs →

Technical Specifications

  • Authentication: Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
  • Response format: JSON with consistent resource schemas and pagination across modules
  • Rate limits: Tuned for enterprise throughput while honoring customer entitlements and usage controls
  • Session management: Automatic reauth and cookie/session rotation with health checks
  • Data freshness: Near real-time retrieval of properties, units, tenants, leases, payments, and maintenance objects
  • Security: Encrypted transport, scoped tokens, and audit logging; respects TenantCloud role-based permissions
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., e‑signatures, payment settlements, maintenance status changes)

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume portfolio sync and lease/payment processing
  • Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
  • Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your modules, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened TenantCloud adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as TenantCloud evolves.

Schedule Integration Call →

Frequently Asked Questions

Q: Which TenantCloud modules can this integration cover?

Supergood supports workflows across commonly used modules such as Portfolio/Units, Tenants & Leases (applications, screenings, e‑signatures), Payments & Accounting (rent, fees, deposits, refunds), and Maintenance/Vendors, subject to your licensing and entitlements. We scope coverage during integration assessment.

Q: How are MFA and SSO handled for automation?

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.

Q: Can you sync rent payments and balances to our accounting system?

Yes. We can normalize payments, fees, refunds, and lease balances to match your ERP/accounting schema and deliver updates via webhooks or polling while complying with rate and permission constraints. We commonly integrate with QuickBooks and Xero.

Q: Are e‑signatures and attachments supported for leases and applications?

Yes. We support downloading signed artifacts and uploading attachments via signed uploads, with checksum validation and time-limited URLs. Signature states and requirements are modeled explicitly in our normalized responses.

Ready to automate your TenantCloud workflows?

Supergood can have your TenantCloud integration live in days with no ongoing engineering maintenance.

Get Started →

Read more