TownSq

Associations

Core information for homeowner associations including identifying data, contact information, and contract terms. Operational configuration (billing, accounting setup, etc.) is managed separately.

Migration Requirements

Required for Import

Yes - Required

Retention History

Include all active associations. Optionally include inactive associations for historical reporting purposes.

Usage Notes

This schema captures core association data for migration purposes.
Operational setup (billing method, fiscal year, coupon configuration, etc.) is managed via operational setup templates.
Address is a single text field to accommodate various international and domestic formats.

Fields (18)

Expand a field to see example values and, where necessary, additional business context

FieldTypeDescriptionAttributes
Association Main
Association IDTextUnique identifier for the source system Association
Required

Association ID

Unique identifier for the source system Association

Examples

ASSOC-001
12345
HOA_SUNNYBROOK

Business Context

This field identifies unique association records from your source system, enabling updates after initial import. Provide any unique identifier from your system—numeric IDs, text codes, or concatenated values all work.

NameTextName of the Association
Required
Legal NameTextLegal entity name noted in Association's governing documents
Required
TypeTextType of association (e.g., Assessment Receivable, Builder Developer, Work Order, etc.)
Optional
Is ActiveTrue/FalseIf Association contract is active
Required
Number Of UnitsNumberTotal number of units/properties in the association
Required
Federal Tax IDTextThe Federal Tax ID for the Association
Required
AddressTextFull address of the Association including street, suite/unit, city, state, county, and zip code
Optional
Contact Information
Manager NameTextThe name of the association manager
Required
Manager PhoneTextPhone number for the association manager
Required
Manager EmailTextEmail address for the association manager
Required
Main Office PhoneTextMain office phone number for the association (not manager-specific)
Optional
Attorney Information
Attorney NameTextThe name of the Attorney for the Association
Optional
Attorney PhoneTextPhone number for the Attorney
Optional
Attorney EmailTextEmail address for the Attorney
Optional
Contract Terms
Contract Start DateDateThe start date of the contract with the management company
Required
Contract End DateDateThe end date of the contract
Optional
Additional Data
Additional DataJSON ObjectAny extra information from your source system
Optional

Relations

delinquenciesDelinquenciesone-to-one

Delinquency configurations for the association

association_bank_accountBank Accountsone-to-one

Bank account information for the association

Associations