What parameters does DELETE /V1/customers/:id accept?

This endpoint accepts 1 parameter: customerId (int) required.

DELETEWebapi · Magento 2.4.9 Admin · Magento_Customer::manage, Magento_Customer::delete

DELETE /V1/customers/:id

Q: What does the DELETE /V1/customers/:id endpoint do in Magento 2?

DELETE /V1/customers/:id is a Magento 2 REST endpoint in the Webapi module. Delete customer by Customer ID. Requires an admin Bearer token with ACL Magento_Customer::manage, Magento_Customer::delete.

Q: Does DELETE /V1/customers/:id require authentication?

This endpoint requires an admin Bearer token with ACL: Magento_Customer::manage, Magento_Customer::delete.

DELETE /V1/customers/:id is a Magento 2 REST endpoint in the Webapi module. Delete customer by Customer ID. Requires an admin Bearer token with ACL Magento_Customer::manage, Magento_Customer::delete.

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

Returns

bool

true on success

Service contract

Magento\Customer\Api\CustomerRepositoryInterface::deleteById

Authorization

Admin Bearer token with ACL:

Magento_Customer::manage
Magento_Customer::delete

Query parameters

customerId int Required

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.