curated-appfolio-common-errors

jeremylongshore/claude-code-plugins-plus-skillsReal EstateAudit pendingSnapshot 1615af5d4d86

Summary

This source did not publish a separate summary. Review SKILL.md before using the skill.

SKILL.md

AppFolio Common Errors

Overview

AppFolio's Stack API powers property management integrations for tenant screening, work orders, lease management, and accounting. Each portfolio operates under its own subdomain ({company}.appfolio.com), meaning a single integration may need to handle multiple base URLs. Errors commonly stem from authentication misconfiguration, incorrect base URLs per portfolio, and business logic violations like duplicate tenant records or conflicting lease dates. Tenant lookup failures (404) are the most frequent issue, typically caused by targeting the wrong portfolio subdomain. This reference covers HTTP-level failures, property-management-specific validation errors, and recovery patterns for the most frequently encountered issues.

Error Reference

Code	Message	Cause	Fix
`401`	`Unauthorized`	Invalid or rotated client_id/secret pair	Regenerate credentials in AppFolio Stack partner portal
`403`	`Forbidden`	Account not approved as Stack partner	Complete partner application at appfolio.com/stack
`404`	`Tenant not found`	Wrong portfolio base URL or deleted tenant	Verify base URL is `{company}.appfolio.com/api/v1`
`409`	`Lease conflict`	Overlapping lease dates for same unit	Check existing leases on unit before creating new one
`422`	`Validation failed`	Missing required fields on work order or tenant	Include all required fields: `unit_id`, `description`, `priority`

interface AppFolioError {
  code: number;
  message: string;
  category: "auth" | "rate_limit" | "validation" | "server";
}

function classifyAppFolioError(status: number, body: string): AppFolioError {
  if (status === 401 || status === 403) {
    return { code: status, message: body, category: "auth" };
  }
  if (status === 429) {
    return { code: 429, message: "Rate limit exceeded", category: "rate_limit" };
  }
  if (status === 404 || status === 409 || status === 422) {
    return { code: status, message: body, category: "validation" };
  }
  return { code: status, message: body, category: "server" };
}

Scenario	Pattern	Recovery
Tenant lookup returns 404	Search by email before creating	Use `/tenants?email=` endpoint
Work order 422	Missing priority field	Default to `normal` if unspecified
Lease date conflict	Overlapping active lease	End existing lease before creating new
Bulk import partial failure	Some records rejected	Parse error array, retry failed records only
Auth token expired mid-batch	401 on subsequent calls	Re-authenticate and resume from last offset

# Verify API connectivity and auth
curl -s -o /dev/null -w "%{http_code}" \
  -u "${APPFOLIO_CLIENT_ID}:${APPFOLIO_CLIENT_SECRET}" \
  "${APPFOLIO_BASE_URL}/api/v1/properties"

curated-appfolio-common-errors

Summary

SKILL.md

AppFolio Common Errors

Overview

Error Reference

Error Handler

Debugging Guide

Authentication Errors

Rate Limit Errors

Validation Errors

Error Handling

Quick Diagnostic

Resources

Next Steps

Related skills