Skip to content
Wink

Update User Profile

PUT
/api/profile
curl --request PUT \
  --url https://api.wink.travel/api/profile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Wink-Version: 2.0' \
  --data '{ "personal": { "address1": "123 Petchburi Road", "address2": "Ratchathewi District", "birthDate": "1985-06-15", "childQuantity": 2, "citizenship": "Thailand", "city": "Bangkok", "contactPerson": [ { "email": "[email protected]", "firstName": "Alexandra", "fullName": "Alexandra Beaumont", "lastName": "Beaumont", "phoneNumber": "+12125551212", "secondaryEmail": "[email protected]", "summary": "John Smith ([email protected] / +12125551212)" } ], "country": "TH", "gender": "FEMALE", "language": "en", "maritalStatus": "MARRIED", "petInfo": [ { "name": "Luna", "type": "Golden Retriever" } ], "postalCode": "10400", "preferredCurrency": "USD", "state": "Bangkok" }, "preferences": { "bedTypePref": "King bed", "cuisinePref": "Thai", "foodSrvcPref": "In-room dining", "guestType": "Business traveler", "hotelChainPref": "Mandarin Oriental", "mealPref": "Continental breakfast", "physChalFeaturePref": "Wheelchair accessible rooms", "propertyLocationPref": "Beachfront", "propertyTypePref": "Luxury Resort", "roomLocationPref": "High floor with city view", "smokingAllowed": false }, "share": true, "user": { "email": "[email protected]", "firstName": "Alexandra", "fullName": "Alexandra Beaumont", "lastName": "Beaumont", "phone": "+66212658866", "profilePictureUrl": "https://res.cloudinary.com/wink/image/upload/v1/user/alexandra-beaumont.jpg" } }'

Updates the authenticated user’s profile with the provided information. Persists personal details, preferences, and sharing settings. Returns the updated profile.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Header Parameters

Section titled “Header Parameters”
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Request Bodyrequired

Section titled “Request Bodyrequired”

User profile data to update

Media typeapplication/json

Request payload for creating or updating the authenticated user’s profile

object
personal

Detailed customer information for this profile

object
address1

Primary address line

string

Example 

123 Petchburi Road
address2

Secondary address line

string

Example 

Ratchathewi District
birthDate

Date of birth in ISO 8601 format

string format: date

Example 

1985-06-15
childQuantity

Number of children

integer format: int32

Example 

2
citizenship

Country of citizenship

string

Example 

Thailand
city

City name

string

Example 

Bangkok
contactPerson
Array<object>

Array of emergency contact information for the customer

object
email

Contact E-mail

string format: email

Example 

[email protected]
firstName

Contact first name

string

Example 

Alexandra
fullName

First and last name

string

Example 

Alexandra Beaumont
lastName

Contact last name

string

Example 

Beaumont
phoneNumber

Contact phone number

string
/^\+?[1-9]\d{1,14}$/

Example 

+12125551212
secondaryEmail

Contact secondary Email

string format: email

Example 

[email protected]
summary

Summary

string

Example 

John Smith ([email protected] / +12125551212)

Example 

{
  "email": "[email protected]",
  "firstName": "Alexandra",
  "fullName": "Alexandra Beaumont",
  "lastName": "Beaumont",
  "phoneNumber": "+12125551212",
  "secondaryEmail": "[email protected]",
  "summary": "John Smith ([email protected] / +12125551212)"
}
country

Country code (ISO 3166-1 alpha-2)

string
/^[A-Z]{2}$/

Example 

TH
gender

Identifies the gender of the customer.

string
Allowed values: MALE FEMALE OTHER

Example 

FEMALE
language

Primary language (ISO 639-1 code)

string
/^[a-z]{2}(-[A-Z]{2})?$/

Example 

en
maritalStatus

Marital status of the traveler

string
Allowed values: ANNULLED COHABITATING DIVORCED ENGAGED MARRIED SEPARATED SINGLE WIDOWED UNKNOWN

Example 

MARRIED
petInfo
Array<object>

Array of customer’s pets

object
name
required

Pet name

string
>= 1 characters

Example 

Luna
type
required

Pet type

string
>= 1 characters

Example 

Golden Retriever

Example 

{
  "name": "Luna",
  "type": "Golden Retriever"
}
physChallName
Array<string>
postalCode

Postal code

string

Example 

10400
preferredCurrency

Preferred currency for monetary values (ISO 4217 code)

string
/^[A-Z]{3}$/

Example 

USD
state

State or province

string

Example 

Bangkok

Example 

{
  "address1": "123 Petchburi Road",
  "address2": "Ratchathewi District",
  "birthDate": "1985-06-15",
  "childQuantity": 2,
  "citizenship": "Thailand",
  "city": "Bangkok",
  "contactPerson": [
    {
      "email": "[email protected]",
      "firstName": "Alexandra",
      "fullName": "Alexandra Beaumont",
      "lastName": "Beaumont",
      "phoneNumber": "+12125551212",
      "secondaryEmail": "[email protected]",
      "summary": "John Smith ([email protected] / +12125551212)"
    }
  ],
  "country": "TH",
  "gender": "FEMALE",
  "language": "en",
  "maritalStatus": "MARRIED",
  "petInfo": [
    {
      "name": "Luna",
      "type": "Golden Retriever"
    }
  ],
  "postalCode": "10400",
  "preferredCurrency": "USD",
  "state": "Bangkok"
}
preferences

Customer preferences

object
allergies

Known allergies

Array<string>
bedTypePref

Preferred hotel bed type

string

Example 

King bed
beveragePref

Beverage preferences

Array<string>
businessSrvcPref

Preferred business services

Array<string>
cuisinePref

Cuisine preference

string

Example 

Thai
foodPref

Food preferences

Array<string>
foodSrvcPref

Preferred food service facilities

string

Example 

In-room dining
guestType

Guest type classification

string

Example 

Business traveler
hotelChainPref

Preferred hotel chain name

string

Example 

Mandarin Oriental
interestPref

Interest preferences

Array<string>
mealPref

Meal preference

string

Example 

Continental breakfast
petsPref

Pet-friendly preferences

Array<string>
physChalFeaturePref

Preferred accessibility features

Array<string>

Example 

Wheelchair accessible rooms
propertyAmenityPref

Preferred hotel property amenities

Array<string>
propertyLocationPref

Preferred hotel property locations

string

Example 

Beachfront
propertyTypePref

Preferred hotel property types

string

Example 

Luxury Resort
recreationSrvcPref

Preferred recreation services

Array<string>
roomAmenityPref

Preferred hotel room amenities

Array<string>
roomLocationPref

Preferred hotel room locations

string

Example 

High floor with city view
securityFeaturePref

Preferred security features

Array<string>
smokingAllowed

Preference for smoking allowed rooms

boolean

Example 

false

Example 

{
  "bedTypePref": "King bed",
  "cuisinePref": "Thai",
  "foodSrvcPref": "In-room dining",
  "guestType": "Business traveler",
  "hotelChainPref": "Mandarin Oriental",
  "mealPref": "Continental breakfast",
  "physChalFeaturePref": "Wheelchair accessible rooms",
  "propertyLocationPref": "Beachfront",
  "propertyTypePref": "Luxury Resort",
  "roomLocationPref": "High floor with city view",
  "smokingAllowed": false
}
share
required

Whether the user wants to share this profile with hotels

boolean

Example 

true
user
required

User details

object
email

User email address

string format: email

Example 

[email protected]
firstName

User first name

string

Example 

Alexandra
fullName

Full name

string

Example 

Alexandra Beaumont
lastName

User last name

string

Example 

Beaumont
phone

User phone number

string
/^\+?[1-9]\d{1,14}$/

Example 

+66212658866
profilePictureUrl

Profile picture URL

string format: uri

Example 

https://res.cloudinary.com/wink/image/upload/v1/user/alexandra-beaumont.jpg

Example 

{
  "email": "[email protected]",
  "firstName": "Alexandra",
  "fullName": "Alexandra Beaumont",
  "lastName": "Beaumont",
  "phone": "+66212658866",
  "profilePictureUrl": "https://res.cloudinary.com/wink/image/upload/v1/user/alexandra-beaumont.jpg"
}

Example 

{
  "personal": {
    "address1": "123 Petchburi Road",
    "address2": "Ratchathewi District",
    "birthDate": "1985-06-15",
    "childQuantity": 2,
    "citizenship": "Thailand",
    "city": "Bangkok",
    "contactPerson": [
      {
        "email": "[email protected]",
        "firstName": "Alexandra",
        "fullName": "Alexandra Beaumont",
        "lastName": "Beaumont",
        "phoneNumber": "+12125551212",
        "secondaryEmail": "[email protected]",
        "summary": "John Smith ([email protected] / +12125551212)"
      }
    ],
    "country": "TH",
    "gender": "FEMALE",
    "language": "en",
    "maritalStatus": "MARRIED",
    "petInfo": [
      {
        "name": "Luna",
        "type": "Golden Retriever"
      }
    ],
    "postalCode": "10400",
    "preferredCurrency": "USD",
    "state": "Bangkok"
  },
  "preferences": {
    "bedTypePref": "King bed",
    "cuisinePref": "Thai",
    "foodSrvcPref": "In-room dining",
    "guestType": "Business traveler",
    "hotelChainPref": "Mandarin Oriental",
    "mealPref": "Continental breakfast",
    "physChalFeaturePref": "Wheelchair accessible rooms",
    "propertyLocationPref": "Beachfront",
    "propertyTypePref": "Luxury Resort",
    "roomLocationPref": "High floor with city view",
    "smokingAllowed": false
  },
  "share": true,
  "user": {
    "email": "[email protected]",
    "firstName": "Alexandra",
    "fullName": "Alexandra Beaumont",
    "lastName": "Beaumont",
    "phone": "+66212658866",
    "profilePictureUrl": "https://res.cloudinary.com/wink/image/upload/v1/user/alexandra-beaumont.jpg"
  }
}

Responses

Section titled “Responses”

200

Section titled “200”

Profile updated successfully

Media typeapplication/json
object
createdDate

Datetime this record was first created

string | null format: date-time
id

Unique identifier for this record.

string format: uuid
lastUpdate

Datetime this record was last updated

string | null format: date-time
personal
required

Detailed customer information for this profile

object
address1

Primary address line

string
address2

Secondary address line

string
birthDate

Date of birth in ISO 8601 format

string format: date
childQuantity

Number of children

integer format: int32
citizenship

Country of citizenship

string
city

City name

string
contactPerson
Array<object>

Array of emergency contact information for the customer

object
email

Contact E-mail

string format: email
firstName

Contact first name

string
fullName

First and last name

string
lastName

Contact last name

string
phoneNumber

Contact phone number

string
/^\+?[1-9]\d{1,14}$/
secondaryEmail

Contact secondary Email

string format: email
summary

Summary

string
country

Country code (ISO 3166-1 alpha-2)

string
/^[A-Z]{2}$/
gender

Identifies the gender of the customer.

string
Allowed values: MALE FEMALE OTHER
language

Primary language (ISO 639-1 code)

string
/^[a-z]{2}(-[A-Z]{2})?$/
maritalStatus

Marital status of the traveler

string
Allowed values: ANNULLED COHABITATING DIVORCED ENGAGED MARRIED SEPARATED SINGLE WIDOWED UNKNOWN
petInfo
Array<object>

Array of customer’s pets

object
name
required

Pet name

string
>= 1 characters
type
required

Pet type

string
>= 1 characters
physChallName
Array<string>
postalCode

Postal code

string
preferredCurrency

Preferred currency for monetary values (ISO 4217 code)

string
/^[A-Z]{3}$/
state

State or province

string
preferences
required

Customer preferences

object
allergies

Known allergies

Array<string>
bedTypePref

Preferred hotel bed type

string
beveragePref

Beverage preferences

Array<string>
businessSrvcPref

Preferred business services

Array<string>
cuisinePref

Cuisine preference

string
foodPref

Food preferences

Array<string>
foodSrvcPref

Preferred food service facilities

string
guestType

Guest type classification

string
hotelChainPref

Preferred hotel chain name

string
interestPref

Interest preferences

Array<string>
mealPref

Meal preference

string
petsPref

Pet-friendly preferences

Array<string>
physChalFeaturePref

Preferred accessibility features

Array<string>
propertyAmenityPref

Preferred hotel property amenities

Array<string>
propertyLocationPref

Preferred hotel property locations

string
propertyTypePref

Preferred hotel property types

string
recreationSrvcPref

Preferred recreation services

Array<string>
roomAmenityPref

Preferred hotel room amenities

Array<string>
roomLocationPref

Preferred hotel room locations

string
securityFeaturePref

Preferred security features

Array<string>
smokingAllowed

Preference for smoking allowed rooms

boolean
profileIdentifier
required

Profile identifier

string format: uuid
>= 1 characters
share
required

Indicates whether the user wants to share this profile of themselves with hotel(s)

boolean
user
required

User details

object
email

User email address

string format: email
firstName

User first name

string
fullName

Full name

string
lastName

User last name

string
phone

User phone number

string
/^\+?[1-9]\d{1,14}$/
profilePictureUrl

Profile picture URL

string format: uri
userIdentifier
required

User identifier

string format: uuid
>= 1 characters
version

Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.

integer | null format: int64

Example 

{
  "createdDate": "2026-01-14T09:30:00",
  "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47",
  "lastUpdate": "2026-02-03T16:45:12",
  "personal": {
    "address1": "123 Petchburi Road",
    "address2": "Ratchathewi District",
    "birthDate": "1985-06-15",
    "childQuantity": 2,
    "citizenship": "Thailand",
    "city": "Bangkok",
    "contactPerson": [
      {
        "email": "[email protected]",
        "firstName": "Alexandra",
        "fullName": "Alexandra Beaumont",
        "lastName": "Beaumont",
        "phoneNumber": "+12125551212",
        "secondaryEmail": "[email protected]",
        "summary": "John Smith ([email protected] / +12125551212)"
      }
    ],
    "country": "TH",
    "gender": "FEMALE",
    "language": "en",
    "maritalStatus": "MARRIED",
    "petInfo": [
      {
        "name": "Luna",
        "type": "Golden Retriever"
      }
    ],
    "postalCode": "10400",
    "preferredCurrency": "USD",
    "state": "Bangkok"
  },
  "preferences": {
    "bedTypePref": "King bed",
    "cuisinePref": "Thai",
    "foodSrvcPref": "In-room dining",
    "guestType": "Business traveler",
    "hotelChainPref": "Mandarin Oriental",
    "mealPref": "Continental breakfast",
    "physChalFeaturePref": "Wheelchair accessible rooms",
    "propertyLocationPref": "Beachfront",
    "propertyTypePref": "Luxury Resort",
    "roomLocationPref": "High floor with city view",
    "smokingAllowed": false
  },
  "profileIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51",
  "share": true,
  "user": {
    "email": "[email protected]",
    "firstName": "Alexandra",
    "fullName": "Alexandra Beaumont",
    "lastName": "Beaumont",
    "phone": "+66212658866",
    "profilePictureUrl": "https://res.cloudinary.com/wink/image/upload/v1/user/alexandra-beaumont.jpg"
  },
  "userIdentifier": "c3a9f2e1-8b4d-4c7a-a1e2-5f0b6d9e2c84",
  "version": 3
}

400

Section titled “400”

Bad Request — missing or invalid request parameter or body

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri

Example generated

{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

401

Section titled “401”

Unauthorized — authentication is required or the session has expired

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri

Example generated

{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

403

Section titled “403”

Forbidden — authenticated but lacking the required permission or scope

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri

Example generated

{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

404

Section titled “404”

Not Found — the requested resource does not exist

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri

Example generated

{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

405

Section titled “405”

Method Not Allowed — the HTTP verb is not supported on this endpoint

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri

Example generated

{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

409

Section titled “409”

Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri

Example generated

{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

415

Section titled “415”

Unsupported Media Type — use application/json

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri

Example generated

{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

500

Section titled “500”

Internal Server Error — an unexpected failure occurred on the server

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri

Example generated

{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

503

Section titled “503”

Service Unavailable — a downstream dependency is unreachable

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri

Example generated

{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}