What does PUT /V1/customers/me return?

The endpoint returns Magento\Customer\Api\Data\CustomerInterface.

Does PUT /V1/customers/me require authentication?

This endpoint requires a Bearer token. The `self` ACL means a customer token (when the caller owns the resource) or an admin token both work.

MageSmith

PUTCustomer · Magento 2.4.9 Self (customer or admin)

PUT /V1/customers/me

Q: What does the PUT /V1/customers/me endpoint do in Magento 2?

PUT /V1/customers/me is a Magento 2 REST endpoint in the Customer module. Create or update a customer. Requires a customer or admin Bearer token (whichever owns the resource).

Q: What parameters does PUT /V1/customers/me accept?

This endpoint accepts 2 parameters: customer (Magento\Customer\Api\Data\CustomerInterface) required; passwordHash (string).

PUT /V1/customers/me is a Magento 2 REST endpoint in the Customer module. Create or update a customer. Requires a customer or admin Bearer token (whichever owns the resource).

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

Magento\Customer\Api\Data\CustomerInterface

Service contract

Magento\Customer\Api\CustomerRepositoryInterface::save

Authorization

Self — a customer Bearer token (when the caller owns the resource) or an admin token both work.

Body parameters

customer Magento\Customer\Api\Data\CustomerInterface Required

passwordHash string default: null

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Authorization

Bearer <ACCESS_TOKEN> customer or admin token (whoever owns the resource)

Path

/V1/customers/me

Body

{
  "customer": {
    "addresses": [
      {
        "city": "",
        "company": "",
        "country_id": "",
        "custom_attributes": [
          {
            "attribute_code": "",
            "value": ""
          }
        ],
        "customer_id": 0,
        "default_billing": false,
        "default_shipping": false,
        "extension_attributes": {},
        "fax": "",
        "firstname": "",
        "id": 0,
        "lastname": "",
        "middlename": "",
        "postcode": "",
        "prefix": "",
        "region": {
          "extension_attributes": {},
          "region": "",
          "region_code": "",
          "region_id": 0
        },
        "region_id": 0,
        "street": [
          {}
        ],
        "suffix": "",
        "telephone": "",
        "vat_id": ""
      }
    ],
    "confirmation": "",
    "created_at": "",
    "created_in": "",
    "custom_attributes": [
      {
        "attribute_code": "",
        "value": ""
      }
    ],
    "default_billing": "",
    "default_shipping": "",
    "disable_auto_group_change": 0,
    "dob": "",
    "email": "",
    "extension_attributes": {},
    "firstname": "",
    "gender": 0,
    "group_id": 0,
    "id": 0,
    "lastname": "",
    "middlename": "",
    "prefix": "",
    "store_id": 0,
    "suffix": "",
    "taxvat": "",
    "updated_at": "",
    "website_id": 0
  },
  "passwordHash": ""
}