---
title: "Add an address"
method: POST
path: "/v1/addresses"
tags: ["Account"]
---

# Add an address

`POST /v1/addresses`

## Request

- Base URL: `https://api.nogpets.com`
- URL: `https://api.nogpets.com/v1/addresses`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://api.nogpets.com/oauth/authorize`, token URL `https://api.nogpets.com/oauth/token`, scopes: `addresses`)
  - HTTP bearer

## Request body

- NewAddress
  - `label` string, required
  - `line1` string, required
  - `suburb` string
  - `city` string
  - `postalCode` string
  - `lat` number
  - `lng` number
  - `notes` string
  - `isDefault` boolean

## Response `201`

The saved address and its coverage

- object
  - `id` string, required
  - `label` string, required
  - `line1` string, required
  - `suburb` string
  - `city` string
  - `postalCode` string
  - `notes` string
  - `isDefault` boolean
  - `covered` boolean, required
  - `lines` LineCoverage[], required
    - `id` string, required
    - `label` string, required
    - `covered` boolean, required

## Other responses

- `400`: The input is wrong (`INVALID_ARGUMENT`, or a pricing code such as `ONE_PRIMARY`, `PET_TYPE`, `UNKNOWN_SERVICE`).
- `401`: No token, or it's expired or revoked. The `WWW-Authenticate` header points at the resource metadata.
- `403`: The token lacks a scope (`INSUFFICIENT_SCOPE`, with `details.scope`).
- `422`: The place couldn't be recognised (`UNKNOWN_PLACE`).

---

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