---
title: "Create an address"
method: POST
path: "/addresses"
tags: ["Addresses"]
---

# Create an address

`POST /addresses`

## Request

- Base URL: `https://api.tidy.com/v1`
- URL: `https://api.tidy.com/v1/addresses`
- Auth: API key in header `X-API-Key`

Add a new property address

## Request body

- AddressCreate
  - `street` string, required
  - `city` string, required
  - `state` string, required
  - `zip` string, required
  - `country` string
  - `nickname` string
  - `access_instructions` string
  - `bedrooms` integer
  - `bathrooms` number, float
  - `square_feet` integer

## Response `201`

Address created successfully

- Address
  - `id` integer
  - `street` string
  - `city` string
  - `state` string
  - `zip` string
  - `country` string
  - `nickname` string, nullable: Friendly name for the property
  - `access_instructions` string, nullable
  - `bedrooms` integer, nullable
  - `bathrooms` number, float, nullable
  - `square_feet` integer, nullable

---

[API](https://skmtc.dev/tidy/apis/tidy-api.md) · [All operations](https://skmtc.dev/tidy/apis/tidy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tidy/apis/tidy-api/revisions/c13f59ecd759?raw)