Set Default Address

🔒

Requires write_customer access scope.

Set a specific address as the default for a given customer.

This API is especially useful for:

  1. Managing default shipping or billing addresses for customers.
  2. Allowing users to quickly access and use their preferred address.
  3. Updating address priority in customer profiles.

Note: The operation is scoped to a specific shop, identified by its unique domain prefix (shopdomain), ensuring all updates are applied to the correct store.

Request Parameters

Public Request Parameters

📘

Public Request Parameters

Path Parameters

ParameterTypeRequiredDescriptionExample
customer_idstringYesUnique identifier of the customer.165618e4-3243-4cd7-abc3-1234567890ab
address_idstringYesUnique identifier of the address.2490dc6a-d511-4e5e-bbcb-d58e913243ad

Response Explanation

Public Response Parameters

📘

Public Response Parameters

Successful Response

Status CodeDescriptionExample Response
200 OKAddress set as default successfully.{}

Error Response

Error responses in the API can be represented using two different fields: errors and error. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.

FieldTypeExampleDescription
errorsEmail or Phone is already taken["Record not found"]A list of errors encountered during the request processing.
FieldTypeExampleDescription
errorString "store is not active"Indicates an error encountered during the process

Error Detail

Status CodeMessagePossible ReasonExample Response
400Bad RequestInvalid input format or request structure (e.g., missing required fields or incorrect data types).Bad Request
UnauthorizedThe request is missing valid authentication credentials or the credentials provided are invalid.Unauthorized
404Record Not FoundThe customer_id and address_id provided is not foundRecord Not Found

API Structure Overview

Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!