API 2026-11-01 Draft contract. Webhook payloads are final for this version; the REST API is in design and not live yet.

ACC requests

Architectural change requests. Homeowners apply through your portal; you push the requests that need a site visit, the inspector reviews them on the drive, and HOACraft sends the review back. A site review is a recommendation only. The committee decision is yours to record.

How it flows

  1. A homeowner applies through your portal. You push the request to HOACraft.
  2. It appears on the inspector's next drive as a site visit, with the application and the matching design rules.
  3. The inspector records what they saw and a recommendation. You get acc_request.site_reviewed.
  4. The committee decides in your system and you POST the decision. HOACraft never approves or denies on its own.

The AccRequest object

idrequiredstring
numberrequiredinteger
statusrequiredstring
One of: submitted siteReviewPending siteReviewed infoRequested approved approvedWithConditions denied
locationrequiredLocation
request_typerequiredstring
One of: fence exteriorPaint shed landscaping solar patio roof
titlerequiredstring
descriptionstring
applicant_namestring
requested_atstring (date-time)
documentsarray of objectNames of the files attached to the application. The files stay in your system.
2 fields
namestring
kindstring
One of: plan colorSample survey quote photo
site_reviewsrequiredarray of SiteReview
decisionAccDecision · nullable

Sample

{
  "id": "acc-wce-201",
  "number": 201,
  "status": "approvedWithConditions",
  "location": {
    "kind": "property",
    "id": "willow-creek-p07",
    "lot_number": "Lot 07",
    "address": "113 Willow Creek Dr",
    "geo": {
      "lat": 30.54713,
      "lng": -97.692082
    }
  },
  "request_type": "fence",
  "title": "Replace rear and side fence",
  "description": "Replace the existing 6 ft fence along rear and left side with new cedar board-on-board, stained Weathered Grey. Same footprint as current fence.",
  "applicant_name": "Owner of record",
  "requested_at": "2026-11-08T18:00:00.000Z",
  "documents": [
    {
      "name": "Site plan.pdf",
      "kind": "plan"
    },
    {
      "name": "Contractor quote.pdf",
      "kind": "quote"
    }
  ],
  "site_reviews": [
    {
      "id": "sr-ho4l8rev40-i",
      "at": "2026-11-13T16:00:00.000Z",
      "by": {
        "id": "staff-dana",
        "name": "Dana Whitfield"
      },
      "outcome": "recommendApproval",
      "observations": "Old fence runs on the survey line; no easement conflict.",
      "measurements": "Proposed height 6 ft, matches neighbours",
      "rules": [
        {
          "id": "wce-adg-3.4",
          "document": "Design Guidelines",
          "section": "3.4",
          "title": "Fences"
        }
      ],
      "photos": [],
      "session_id": "sess-ho4l8rev40-0"
    }
  ],
  "decision": {
    "decision": "approvedWithConditions",
    "decided_at": "2026-11-13T16:00:00.000Z",
    "recorded_by": {
      "id": "staff-marcus",
      "name": "Marcus Lee"
    },
    "conditions": "Stain within 60 days to an Earth Palette colour."
  }
}

Webhook events

Sent to your endpoint as they happen, signed as described in Webhooks & signing. The samples are real output from the HOACraft app, checked against the code on every build.

EVENTacc_request.site_reviewed

An inspector recorded an ACC site review (a recommendation, not a decision)

data fields

acc_requestrequiredAccRequest
site_reviewrequiredSiteReview

Sample payload

{
  "id": "evt-ho4l8rev40-k",
  "type": "acc_request.site_reviewed",
  "api_version": "2026-11-01",
  "created_at": "2026-11-13T16:00:00.000Z",
  "community": {
    "id": "willow-creek",
    "name": "Willow Creek Estates"
  },
  "data": {
    "acc_request": {
      "id": "acc-wce-201",
      "number": 201,
      "status": "siteReviewed",
      "location": {
        "kind": "property",
        "id": "willow-creek-p07",
        "lot_number": "Lot 07",
        "address": "113 Willow Creek Dr",
        "geo": {
          "lat": 30.54713,
          "lng": -97.692082
        }
      },
      "request_type": "fence",
      "title": "Replace rear and side fence",
      "description": "Replace the existing 6 ft fence along rear and left side with new cedar board-on-board, stained Weathered Grey. Same footprint as current fence.",
      "applicant_name": "Owner of record",
      "requested_at": "2026-11-08T18:00:00.000Z",
      "documents": [
        {
          "name": "Site plan.pdf",
          "kind": "plan"
        },
        {
          "name": "Contractor quote.pdf",
          "kind": "quote"
        }
      ],
      "site_reviews": [
        {
          "id": "sr-ho4l8rev40-i",
          "at": "2026-11-13T16:00:00.000Z",
          "by": {
            "id": "staff-dana",
            "name": "Dana Whitfield"
          },
          "outcome": "recommendApproval",
          "observations": "Old fence runs on the survey line; no easement conflict.",
          "measurements": "Proposed height 6 ft, matches neighbours",
          "rules": [
            {
              "id": "wce-adg-3.4",
              "document": "Design Guidelines",
              "section": "3.4",
              "title": "Fences"
            }
          ],
          "photos": [],
          "session_id": "sess-ho4l8rev40-0"
        }
      ],
      "decision": null
    },
    "site_review": {
      "id": "sr-ho4l8rev40-i",
      "at": "2026-11-13T16:00:00.000Z",
      "by": {
        "id": "staff-dana",
        "name": "Dana Whitfield"
      },
      "outcome": "recommendApproval",
      "observations": "Old fence runs on the survey line; no easement conflict.",
      "measurements": "Proposed height 6 ft, matches neighbours",
      "rules": [
        {
          "id": "wce-adg-3.4",
          "document": "Design Guidelines",
          "section": "3.4",
          "title": "Fences"
        }
      ],
      "photos": [],
      "session_id": "sess-ho4l8rev40-0"
    }
  }
}
EVENTacc_request.decided

A manager recorded the committee decision in HOACraft

data fields

acc_requestrequiredAccRequest

Sample payload

{
  "id": "evt-ho4l8rev40-o",
  "type": "acc_request.decided",
  "api_version": "2026-11-01",
  "created_at": "2026-11-13T16:00:00.000Z",
  "community": {
    "id": "willow-creek",
    "name": "Willow Creek Estates"
  },
  "data": {
    "acc_request": {
      "id": "acc-wce-201",
      "number": 201,
      "status": "approvedWithConditions",
      "location": {
        "kind": "property",
        "id": "willow-creek-p07",
        "lot_number": "Lot 07",
        "address": "113 Willow Creek Dr",
        "geo": {
          "lat": 30.54713,
          "lng": -97.692082
        }
      },
      "request_type": "fence",
      "title": "Replace rear and side fence",
      "description": "Replace the existing 6 ft fence along rear and left side with new cedar board-on-board, stained Weathered Grey. Same footprint as current fence.",
      "applicant_name": "Owner of record",
      "requested_at": "2026-11-08T18:00:00.000Z",
      "documents": [
        {
          "name": "Site plan.pdf",
          "kind": "plan"
        },
        {
          "name": "Contractor quote.pdf",
          "kind": "quote"
        }
      ],
      "site_reviews": [
        {
          "id": "sr-ho4l8rev40-i",
          "at": "2026-11-13T16:00:00.000Z",
          "by": {
            "id": "staff-dana",
            "name": "Dana Whitfield"
          },
          "outcome": "recommendApproval",
          "observations": "Old fence runs on the survey line; no easement conflict.",
          "measurements": "Proposed height 6 ft, matches neighbours",
          "rules": [
            {
              "id": "wce-adg-3.4",
              "document": "Design Guidelines",
              "section": "3.4",
              "title": "Fences"
            }
          ],
          "photos": [],
          "session_id": "sess-ho4l8rev40-0"
        }
      ],
      "decision": {
        "decision": "approvedWithConditions",
        "decided_at": "2026-11-13T16:00:00.000Z",
        "recorded_by": {
          "id": "staff-marcus",
          "name": "Marcus Lee"
        },
        "conditions": "Stain within 60 days to an Earth Palette colour."
      }
    }
  }
}

Endpoints

Planned REST API, not live yet. Base URL https://sandbox.api.hoacraft.com/v1, Authorization: Bearer <key>. See basics.

Push ACC requests that need a site visit

PUT/communities/{communityId}/acc-requests

Rows are matched on external_id. Each new request appears on the inspector's open-items drive until it has a site review. Requests you omit are left alone; close them with a decision instead.

Parameters

communityIdrequiredpath · string

Request body

acc_requestsrequiredarray of AccRequestInput up to 1000 items

Responses

200Per-row outcomeobject
422Validation failedError

Example request

curl -X PUT "https://sandbox.api.hoacraft.com/v1/communities/willow-creek/acc-requests" \
  -H "Authorization: Bearer $HOACRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "acc_requests": [
    {
      "external_id": "string",
      "property_external_id": "string",
      "request_type": "fence",
      "title": "string",
      "description": "string",
      "applicant_name": "string",
      "requested_at": "2026-11-13T16:00:00Z",
      "review_by": "2026-11-13T16:00:00Z",
      "documents": [
        {
          "name": "string",
          "kind": "plan",
          "url": "https://pm.example.com/integrations/hoacraft/webhook"
        }
      ]
    }
  ]
}'
Example response
{
  "created": 1,
  "updated": 1,
  "errors": [
    {
      "index": 1,
      "external_id": "string",
      "message": "string"
    }
  ]
}

List ACC requests

GET/acc-requests

Parameters

community_idquery · string
statusquery · string
updated_sincequery · string (date-time)
cursorquery · string
limitquery · integer default 100 · min 1 · max 500

Responses

200A page of ACC requests, oldest change first.object

Example request

curl -X GET "https://sandbox.api.hoacraft.com/v1/acc-requests" \
  -H "Authorization: Bearer $HOACRAFT_API_KEY"
Example response
{
  "data": [
    {
      "id": "acc-wce-201",
      "number": 201,
      "status": "approvedWithConditions",
      "location": {
        "kind": "property",
        "id": "willow-creek-p07",
        "lot_number": "Lot 07",
        "address": "113 Willow Creek Dr",
        "geo": {
          "lat": 30.54713,
          "lng": -97.692082
        }
      },
      "request_type": "fence",
      "title": "Replace rear and side fence",
      "description": "Replace the existing 6 ft fence along rear and left side with new cedar board-on-board, stained Weathered Grey. Same footprint as current fence.",
      "applicant_name": "Owner of record",
      "requested_at": "2026-11-08T18:00:00.000Z",
      "documents": [
        {
          "name": "Site plan.pdf",
          "kind": "plan"
        },
        {
          "name": "Contractor quote.pdf",
          "kind": "quote"
        }
      ],
      "site_reviews": [
        {
          "id": "sr-ho4l8rev40-i",
          "at": "2026-11-13T16:00:00.000Z",
          "by": {
            "id": "staff-dana",
            "name": "Dana Whitfield"
          },
          "outcome": "recommendApproval",
          "observations": "Old fence runs on the survey line; no easement conflict.",
          "measurements": "Proposed height 6 ft, matches neighbours",
          "rules": [
            {
              "id": "wce-adg-3.4",
              "document": "Design Guidelines",
              "section": "3.4",
              "title": "Fences"
            }
          ],
          "photos": [],
          "session_id": "sess-ho4l8rev40-0"
        }
      ],
      "decision": {
        "decision": "approvedWithConditions",
        "decided_at": "2026-11-13T16:00:00.000Z",
        "recorded_by": {
          "id": "staff-marcus",
          "name": "Marcus Lee"
        },
        "conditions": "Stain within 60 days to an Earth Palette colour."
      }
    }
  ],
  "next_cursor": "string"
}

Get an ACC request with its site reviews

GET/acc-requests/{accRequestId}

Parameters

accRequestIdrequiredpath · string

Responses

200OKAccRequest
404Not foundError

Example request

curl -X GET "https://sandbox.api.hoacraft.com/v1/acc-requests/acc-wce-201" \
  -H "Authorization: Bearer $HOACRAFT_API_KEY"
Example response
{
  "id": "acc-wce-201",
  "number": 201,
  "status": "approvedWithConditions",
  "location": {
    "kind": "property",
    "id": "willow-creek-p07",
    "lot_number": "Lot 07",
    "address": "113 Willow Creek Dr",
    "geo": {
      "lat": 30.54713,
      "lng": -97.692082
    }
  },
  "request_type": "fence",
  "title": "Replace rear and side fence",
  "description": "Replace the existing 6 ft fence along rear and left side with new cedar board-on-board, stained Weathered Grey. Same footprint as current fence.",
  "applicant_name": "Owner of record",
  "requested_at": "2026-11-08T18:00:00.000Z",
  "documents": [
    {
      "name": "Site plan.pdf",
      "kind": "plan"
    },
    {
      "name": "Contractor quote.pdf",
      "kind": "quote"
    }
  ],
  "site_reviews": [
    {
      "id": "sr-ho4l8rev40-i",
      "at": "2026-11-13T16:00:00.000Z",
      "by": {
        "id": "staff-dana",
        "name": "Dana Whitfield"
      },
      "outcome": "recommendApproval",
      "observations": "Old fence runs on the survey line; no easement conflict.",
      "measurements": "Proposed height 6 ft, matches neighbours",
      "rules": [
        {
          "id": "wce-adg-3.4",
          "document": "Design Guidelines",
          "section": "3.4",
          "title": "Fences"
        }
      ],
      "photos": [],
      "session_id": "sess-ho4l8rev40-0"
    }
  ],
  "decision": {
    "decision": "approvedWithConditions",
    "decided_at": "2026-11-13T16:00:00.000Z",
    "recorded_by": {
      "id": "staff-marcus",
      "name": "Marcus Lee"
    },
    "conditions": "Stain within 60 days to an Earth Palette colour."
  }
}

Record the committee decision

POST/acc-requests/{accRequestId}/decision

Closes the request in HOACraft and takes it off the drive. A decision can be recorded once. HOACraft never approves or denies on its own.

Parameters

accRequestIdrequiredpath · string

Request body

decisionrequiredstring
One of: approved approvedWithConditions denied
decided_atrequiredstring (date-time)
conditionsstring

Responses

200RecordedAccRequest
404Not foundError
409A decision is already recorded.Error

Example request

curl -X POST "https://sandbox.api.hoacraft.com/v1/acc-requests/acc-wce-201/decision" \
  -H "Authorization: Bearer $HOACRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "decision": "approved",
  "decided_at": "2026-11-13T16:00:00Z",
  "conditions": "string"
}'
Example response
{
  "id": "acc-wce-201",
  "number": 201,
  "status": "approvedWithConditions",
  "location": {
    "kind": "property",
    "id": "willow-creek-p07",
    "lot_number": "Lot 07",
    "address": "113 Willow Creek Dr",
    "geo": {
      "lat": 30.54713,
      "lng": -97.692082
    }
  },
  "request_type": "fence",
  "title": "Replace rear and side fence",
  "description": "Replace the existing 6 ft fence along rear and left side with new cedar board-on-board, stained Weathered Grey. Same footprint as current fence.",
  "applicant_name": "Owner of record",
  "requested_at": "2026-11-08T18:00:00.000Z",
  "documents": [
    {
      "name": "Site plan.pdf",
      "kind": "plan"
    },
    {
      "name": "Contractor quote.pdf",
      "kind": "quote"
    }
  ],
  "site_reviews": [
    {
      "id": "sr-ho4l8rev40-i",
      "at": "2026-11-13T16:00:00.000Z",
      "by": {
        "id": "staff-dana",
        "name": "Dana Whitfield"
      },
      "outcome": "recommendApproval",
      "observations": "Old fence runs on the survey line; no easement conflict.",
      "measurements": "Proposed height 6 ft, matches neighbours",
      "rules": [
        {
          "id": "wce-adg-3.4",
          "document": "Design Guidelines",
          "section": "3.4",
          "title": "Fences"
        }
      ],
      "photos": [],
      "session_id": "sess-ho4l8rev40-0"
    }
  ],
  "decision": {
    "decision": "approvedWithConditions",
    "decided_at": "2026-11-13T16:00:00.000Z",
    "recorded_by": {
      "id": "staff-marcus",
      "name": "Marcus Lee"
    },
    "conditions": "Stain within 60 days to an Earth Palette colour."
  }
}