Skip to content

Create or Update an Address

Request

Adds address info to user profile.

List of required fields are different for different countries. Use the address requirements endpoint to dynamically discover required fields.

For updating personal profiles, consider using the personal profile update endpoint 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.

Security
UserToken or PersonalToken
Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Example:f47ac10b-58cc-4372-a567-0e02b2c3d479
Bodyapplication/jsonrequired
profileinteger, (int64)required

User profile ID.

Example:12345678
detailsobjectrequired

Address details.

curl -i -X POST \
  https://api.wise.com/2026Q3/addresses \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479' \
  -d '{
    "profile": 12345678,
    "details": {
      "country": "US",
      "firstLine": "50 Sunflower Ave",
      "postCode": "10025",
      "city": "Phoenix",
      "state": "AZ",
      "occupations": [
        {
          "code": "Software Engineer",
          "format": "FREE_FORM"
        }
      ]
    }
  }'

Responses

OK - Address successfully created or updated.

Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

Echoed back when X-External-Correlation-Id was included in the request. Learn more.

Example:"f47ac10b-58cc-4372-a567-0e02b2c3d479"
x-trace-idstring

Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.

Example:"fba501b6d453b96789f52338f019341f"
Bodyapplication/json
idinteger, (int64)

Address ID.

Example:10000001
profileinteger, (int64)

User profile ID.

Example:12345678
detailsobject

Address details.

Response
{
  "id": 10000001,
  "profile": 12345678,
  "details": {
    "country": "US",
    "state": "AZ",
    "city": "Phoenix",
    "postCode": "10025",
    "firstLine": "50 Sunflower Ave",
    "occupations": [
      { … }
    ]
  }
}