Defining the Create Entity workflow step

CRM Workflows support a create entity step action that can be added and defined on the CRM Workflow Designer tab. The Create Entity step creates a new entity record. The new record is created based on the step definition. All string, datetime, and key property types can be assigned both @mention values and static text to create complex result strings.
Note: Relationship-based properties are not available to define when creating or editing an entity.
  • If an entity requires a relationship-based property and the business logic does not provide a default value for that property, that entity cannot be created and the step fails and proceed to the step defined for Error.
  • Any parent relationships for the new entities are automatically assigned if they match the current workflow entity.

To define a CRM Workflow Create Entity step:

  1. Click the Workflow Designer tab. See Workflow Designer Tab.
  2. Click the Add icon for the step that precedes the Create Entity step. The Insert New Workflow Step window is displayed.
  3. Select the Create Entity step. The Create Entity step is added to the workflow. See Inserting a new CRM workflow step.
  4. Double-click the Create Entity step, or right-click the Create Entity step and click Edit in the Icon view to view the Create Entity step editor.
    Note: You can also click the Settings icon in the upper right corner of the card in Card view.
  5. Specify this information on the General tab:
    Caption
    The text that displays as a label for this step.
    Delay Duration
    A numeric value for a delay in days, hours, or minutes before this step is triggered, if required.
    Delay Increment

    Specifies the time increment used for the delay duration. Select in Days, Hours, or Minutes to define the unit in which the delay duration is measured before this step is triggered. Possible values:

    • Days
    • Hours
    • Minutes
    Edit Condition
    You can use Edit Condition to define the condition criteria that must be met before the step is triggered. See Defining CRM Workflow step conditions.
  6. Define the entity options using the Create Entity Options tab:
    1. Entity

      Click the Search and use the Lookup to find and select the entity to be associated with the step, and then click OK.

    2. Entity Properties

      Click the Search and use the Lookup to find and select all of the required properties to define for the new entity, and then click Add Selected.

      • To add additional properties, click the Search and use the Lookup to find and select all additional properties. The selected properties are added to the list.
      • To remove a property from the list, click the Remove next to the property to be removed.
    3. Define each of the Selected Properties by typing or selecting the desired information to be set when the entity is created.
      • For string properties you can type a static value or use the @mention user interface to select a token from the popup listing to include dynamic application content. Type the ‘@’ character followed by a portion of the required token content.
      • For date or time properties you can type a static value or use the @mention user interface to select a token from the popup listing to include dynamic application content.
        • For static values: You can use any of these supported date and time formats:
          • 05/01/2009 14:57:32.8
          • 2009-05-01 14:57:32.8
          • 2009-05-01T14:57:32.8375298-04:00
          • 5/01/2008
          • 05/01/2008
          • 5/01/2008 14:57:32.80 -07:00
          • 1 May 2008 2:57:32.8 PM
          • Fri, 15 May 2009 20:10:57 GMT
          • 2023-11-05T13:15:30Z
        • For dynamic values: Type the ‘@’ character followed by a portion of the desired token content.
      • For a date and time field, you can also specify a day incrementor using a date @mention token. For example, $CurrentDate +7 calculates the date as 7 days after the date the step is triggered.
      • Select or clear the check box for Boolean properties.
        • For numeric properties, type a number or use the up and down arrows to select a number value.
        Note: 
        • You must define any required properties, or the created entity step fails.
        • If a property type is not supported the text Property type is not supported is displayed and the application recommends removing that property from the list.
  7. Click OK
    Note: 
    • Create and define next step if the Create Entity step completes:
      • Click the Complete Add icon after the Create Entity step.
      • Select the required step action.
      • Define the step.
    • Create and define next step if the Create Entity step results in an error:
      • Click the Error Add icon after the Create Entity step.
      • Select the required step action.
      • Define the step.