This endpoint allows you to update the data of an existing address. You must send the customer ID and the address ID in the path, and in the request body the fields you want to update (zip code, street name, city, state, country, and optional fields). In case of success, the request will return a response with status 200 containing the updated address.
PUT
REQUIRED
REQUIRED
REQUIRED
400Request error.
100
The credentials are required. Provide a valid access token in the Authorization header.
214
The zip code format is invalid. Provide a valid postal code according to the country's format.
217
The parameter must be a string. Check the data type of the field and ensure it is sent as a string.
222
The parameter length exceeds the maximum allowed or must be a positive value. Check the field length and value constraints.
validation_error
Validation error. One or more fields failed validation. Check the request body and ensure all required fields are correctly formatted.
401Error. Access Token not authorized.
unauthorized
Unauthorized access. The provided access token is invalid or expired. Verify your credentials and try again.
404Error. Requested resource not found.
not_found
The requested resource was not found. Verify that the customer ID and address ID are correct and that the address exists.
500Generic error.
internal_error
Internal server error. Please try again later or contact support if the issue persists.
curl -X PUT \
'https://api.mercadopago.com/v1/customers/{id}/addresses/{address_id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-d '{
"zip_code": "01234567",
"street_name": "Rua Exemplo",
"street_number": 123,
"name": "Home",
"phone": "11987654321",
"floor": "3",
"apartment": "A",
"comments": "Near the park",
"city": {
"id": "BR-SP-44",
"name": "São Paulo"
},
"state": {
"id": "BR-SP",
"name": "São Paulo"
},
"neighborhood": {
"name": "Jardim Ipanema"
}
}'{
"id": "1162600213",
"street_name": "Rua Exemplo",
"zip_code": "01234567",
"city": {
"id": "BR-SP-44",
"name": "São Paulo"
},
"state": {
"id": "BR-SP",
"name": "São Paulo"
},
"country": {
"id": "BR",
"name": "Brasil"
},
"neighborhood": {
"name": "Jardim Ipanema"
},
"municipality": {},
"date_created": "2021-03-16T15:45:17.000-04:00",
"live_mode": true
}