API Reference › Property Search

Create a Saved Template

POST /v1/api/property-search/templates/

Cost: Free.

Rate limit: 60 requests per minute per account.

Mode: Sync

A template is a saved, reusable lead-list configuration, a strategy, geography, and optional filter overrides you can re-run on demand or attach a Monitor to. Templates are free to create and store; you're only billed when you actually build a list from one via /execute/ (pass the template's id as template_id) or when a Monitor delivers. GET returns your active templates. POST creates one. Templates are owner-scoped, you only ever see your own. Related endpoints: Get a Saved Template · Update a Saved Template · Delete a Saved Template

Fields

name (required): Label for the template (max 120 chars).
strategy (required): A preset key (or comma-separated keys) from GET /filters/, or 'custom'.
geography (required): Same shape as /execute/, e.g. {"mode": "city", "cities": ["Phoenix"], "states": ["AZ"]}.
filter_overrides: Optional filters merged on top of the strategy. Validated against the same whitelist as /execute/.

Responses

201: POST: 201 Created
400: Unknown strategy
429: Rate limit reached: 60 requests per minute per account.