---
title: "Create or Update an Address"
method: POST
path: "/v1/addresses"
tags: ["address"]
---

# Create or Update an Address

`POST /v1/addresses`

Adds address info to user profile.

List of required fields are different for different countries. Use the [address requirements endpoint](#operation/addressRequirementsGet) to dynamically discover required fields.

For updating personal profiles, consider using [the personal profile update endpoint](/api-reference/profile/profilepersonalupdate) instead. It allows submitting the address information alongside other profile data.

**State field** is required for US, CA, BR, and AU addresses.

**Occupations** is required for CA, IN, JP, ID, IL, MX, and within the US for the state NM.

## Headers

- `X-External-Correlation-Id` string, uuid

## Request body

- AddressRequest — Request payload for creating or updating an address.
  - `profile` integer, required — User profile ID.
  - `details` object, required — Address details.
    - `country` string, required — Country code (ISO 3166-1 alpha-2).
    - `firstLine` string, required — Address line: street, house, apartment.
    - `postCode` string, required — Postal / zip code (max 30 characters).
    - `city` string, required — City name.
    - `state` string — State code. Required if country is US, CA, BR, or AU.
    - `occupations` object[] — User occupations. Required for CA, IN, JP, ID, IL, MX, and within the US for state NM.
      - `code` string — User occupation - any value permitted.
      - `format` 'FREE_FORM' — Occupation type - always `FREE_FORM`.

## Response `200`

OK - Address successfully created or updated.

- Address — Represents a physical address associated with a profile.
  - `id` integer — Address ID.
  - `profile` integer — User profile ID.
  - `details` object — Address details.
    - `country` string — Country code (ISO 3166-2 Country Code).
    - `firstLine` string — Address line: street, house, apartment.
    - `postCode` string — Postal or zip code (max 30 characters).
    - `city` string — City name.
    - `state` string — State code. Required if country is US, CA, BR, or AU.
    - `occupations` object[] — User occupations. Required for CA, IN, JP, ID, IL, MX, and within the US for state NM.
      - `code` string — User occupation - any value permitted.
      - `format` 'FREE_FORM' — Occupation type - always `FREE_FORM`.

## Other responses

- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)