Skills Development AppFolio Webhook Event Handler

AppFolio Webhook Event Handler

v20260423
appfolio-webhooks-events
This skill provides robust mechanisms to handle real-time webhook events from the AppFolio property management platform. It processes critical lifecycle events such as tenant onboarding, lease signings, rent payments, and maintenance work order updates. By utilizing these webhooks, developers can securely and instantly sync AppFolio data with external systems (e.g., CRM, accounting, custom dashboards), avoiding inefficient API polling and ensuring data consistency.
Get Skill
248 downloads
Overview

AppFolio Webhooks & Events

Overview

AppFolio Stack delivers real-time webhook notifications for property management lifecycle events including tenant onboarding, lease execution, rent payments, and maintenance workflows. Use these webhooks to sync AppFolio data with your CRM, accounting system, or custom property management dashboards without polling the API.

Webhook Registration

const response = await fetch("https://api.appfolio.com/v1/webhooks", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.APPFOLIO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://yourapp.com/webhooks/appfolio",
    events: ["tenant.created", "work_order.updated", "payment.received", "lease.signed"],
    secret: process.env.APPFOLIO_WEBHOOK_SECRET,
  }),
});

Signature Verification

import crypto from "crypto";
import { Request, Response, NextFunction } from "express";

function verifyAppFolioSignature(req: Request, res: Response, next: NextFunction) {
  const signature = req.headers["x-appfolio-signature"] as string;
  const expected = crypto
    .createHmac("sha256", process.env.APPFOLIO_WEBHOOK_SECRET!)
    .update(req.body)
    .digest("hex");
  if (!crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) {
    return res.status(401).json({ error: "Invalid signature" });
  }
  next();
}

Event Handler

import express from "express";
const app = express();

app.post("/webhooks/appfolio", express.raw({ type: "application/json" }), verifyAppFolioSignature, (req, res) => {
  const event = JSON.parse(req.body.toString());
  res.status(200).json({ received: true });

  switch (event.type) {
    case "tenant.created":
      syncTenantToCRM(event.data.tenant_id, event.data.property_id); break;
    case "work_order.updated":
      notifyMaintenanceTeam(event.data.work_order_id, event.data.status); break;
    case "payment.received":
      recordPayment(event.data.lease_id, event.data.amount_cents); break;
    case "lease.signed":
      activateLease(event.data.lease_id, event.data.move_in_date); break;
  }
});

Event Types

EventPayload FieldsUse Case
tenant.createdtenant_id, property_id, emailSync new tenant to CRM
work_order.updatedwork_order_id, status, assigned_vendorDispatch or escalate maintenance
payment.receivedlease_id, amount_cents, payment_methodUpdate accounting ledger
lease.signedlease_id, move_in_date, term_monthsActivate unit and send welcome
lease.expiredlease_id, unit_id, vacate_dateTrigger renewal or re-listing

Retry & Idempotency

const processed = new Set<string>();

async function handleIdempotent(event: { id: string; type: string; data: any }) {
  if (processed.has(event.id)) return;
  await routeEvent(event);
  processed.add(event.id);
  if (processed.size > 10_000) {
    const entries = Array.from(processed);
    entries.slice(0, entries.length - 10_000).forEach((id) => processed.delete(id));
  }
}

Error Handling

IssueCauseFix
Signature mismatchWrong secret or parsed bodyUse express.raw() for verification
Duplicate eventsAppFolio retry on timeoutTrack event IDs for idempotency
Missing property_idEvent from archived propertyCheck property status before processing
5xx from handlerDownstream service unavailableReturn 200 immediately, process async

Resources

Next Steps

See appfolio-security-basics.

Info
Category Development
Name appfolio-webhooks-events
Version v20260423
Size 4.02KB
Updated At 2026-04-28
Language