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
- A homeowner applies through your portal. You push the request to HOACraft.
- It appears on the inspector's next drive as a site visit, with the application and the matching design rules.
- The inspector records what they saw and a recommendation. You get
acc_request.site_reviewed. - 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 object | Names of the files attached to the application. The files stay in your system.2 fields
| ||||
| 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.
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"
}
}
}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
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
| 200 | Per-row outcomeobject |
| 422 | Validation 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
Parameters
| community_idquery · string | |
| statusquery · string | |
| updated_sincequery · string (date-time) | |
| cursorquery · string | |
| limitquery · integer | default 100 · min 1 · max 500 |
Responses
| 200 | A 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
Parameters
| accRequestIdrequiredpath · string |
Responses
| 200 | OKAccRequest |
| 404 | Not 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
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
| 200 | RecordedAccRequest |
| 404 | Not foundError |
| 409 | A 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."
}
}