Delete Entity

Audience: Low-code Engineers

Skill Prerequisites: Actions, Tokens, Connectors

Deletes a record (entity) from Microsoft Dynamics 365 / Dynamics CRM. You identify the record by its entity logical name and ID (GUID).

note

This action is part of the Dynamics (CRM, 365) add-on. The add-on is installed separately and requires the DYNCRM feature to be licensed. If it isn't licensed, the action fails with a message that the feature is unlicensed.

Typical Use Cases

• Remove a contact from Dynamics when a user deletes their account in your application
• Clean up test or duplicate records from a workflow

Don't use it to

• Deactivate or close a record. Use Update Entity to change its status instead.
• Delete records without knowing their ID. Find the ID first with Find Entity or Read Multiple Entities.

Related Actions

Action Name	Description
Create Entity	Creates a new Dynamics record.
Update Entity	Changes attributes of an existing Dynamics record.
Find Entity	Finds a Dynamics record that matches conditions.
Read Entity	Reads attributes of a Dynamics record by its ID.
Read Multiple Entities	Reads a list of Dynamics records.

Input Parameter Reference

Parameter	Description	Supports Tokens	Default	Required
Connector	The Dynamics Service Connector to use. See Connecting to Dynamics.	No	none	Yes
Logical Name	The entity the record belongs to. The list shows the entities of the selected connector by display name, and saves the logical name, for example contact. You can also type a logical name or use a token. The value is changed to lowercase.	Yes	none	Yes
Entity Guid	The ID (GUID) of the record to delete, for example [ContactId].	Yes	none	Yes

This action has no output tokens.

Considerations

• Deleting can't be undone. Add a condition or a confirmation step before this action.
• The record must exist. If Dynamics can't find a record with that ID, the action fails with the error from Dynamics.
• Permissions come from the connector. The Dynamics user in the connector must be allowed to delete records of that entity.
• Errors stop the flow. To handle them, put the action inside Execute Actions and use its On Error actions. See Common Parameters for Condition and the other common settings.

Examples

tip

To understand how to use the below examples, please see Running Examples.

1. Delete a contact

This action deletes the contact whose ID is in [ContactId], but only when ContactId has a value. The connector ID is in the [DynamicsConnectorId] token.

{
    "Title": "Delete Entity",
    "ActionType": "DynamicsCrm.DeleteEntity",
    "Description": "Remove the contact from Dynamics",
    "Condition": "[ContactId] != \"\"",
    "Parameters": {
        "Credentials": {
            "IsExpression": true,
            "Entry": "[DynamicsConnectorId]"
        },
        "LogicalName": "contact",
        "EntityGuid": "[ContactId]"
    }
}

Revised 09/27/2026