This document provides an overview of Town’s Partner API, webhooks, and dashboard used by our partners to refer their customers to us and track the state of these referrals through the tax prep and filing process.

Town API & Key Concepts

Our API docs are available at https://api.town.com.

Key concepts of the Town product and API:

For simplicity, we start with a 1:1 mapping between entities and clients for partner referrals, but the partner can use the API to add other relationships if necessary.

Refer a customer to Town

There are a few ways the partner can refer a customer (i.e., a client and their entity) to Town, in order from the easiest (and simplest) to most customizable and seamless:

More on each of these two options below.

Option 1: Partner-specific URL

Flow overview

When a partner starts working with Town, they will be provided with a partner specific URL in the format of: