deleteRecord (Client API reference)

Deletes a table record.


Xrm.WebApi.deleteRecord(entityLogicalName, id).then(successCallback, errorCallback);


Name Type Required Description
entityLogicalName String Yes The table logical name of the record you want to delete. For example: account.
id String Yes GUID of the table record you want to delete.
successCallback Function No A function to call when a record is deleted. See Return Value
errorCallback Function No A function to call when the operation fails.

Return Value

On success, returns a promise object to the successCallback with the following properties:

Name Type Description
entityType String The table logical name of the record.
id String GUID of the record.
name String Name of the record.


These examples use some of the same request objects as demonstrated in Update and delete tables using the Web API to define the data object for updating an entity record.

Deletes an account with record ID = 5531d753-95af-e711-a94e-000d3a11e605.

Xrm.WebApi.deleteRecord("account", "5531d753-95af-e711-a94e-000d3a11e605").then(
    function success(result) {
        console.log("Account deleted");
        // perform operations on record deletion
    function (error) {
        // handle error conditions