---
title: Workflow XML Reference - Action Properties
slug: rm/workflow-xml-reference-action-properties
docTags: 
createdAt: 2026-06-09T13:38:48.816Z
---

The following lists the parameters that can or must be included when defining a triggered action:

# Triggered Action: EmailNotificationAction

| **Properties**         | **Property Requirement** | **Notes**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ---------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Emails or PropertyName | Required                 | - Sends a message to the specified users about the action<br />- Users are specified either as individual email addresses or a user group name<br />- Contains the following child-element structure:<br /><br />`<PropertyName>`name of the user group`</PropertyName>`<br />`<Message>`message sent to recipients`</Message>`<br /><br />OR<br /><br />`<Emails>`<br />`<Email>`email address 1`</Email>`<br />`<Email>`email address 2`</Email>`<br />`<Email>`email address n`</Email>`<br />`</Emails>`<br />`<Message>`message sent to recipients`</Message>` |
| Message                | Required                 | The message sent to specified users about the action                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

# Triggered Action: PropertyChangeAction

| **Properties** | **Property Requirement**                                                                                                                                                                         | **Notes**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| PropertyName   | Required                                                                                                                                                                                         | - The name of the standard artifact property that is changing                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| PropertyValue  |                                                                                                                                                                                                  | - Applies to one of the following standard artifact types: text, number, and date<br />- Replaces the existing value<br />- Contains the following child-element structure:<br />`<PropertyName>`name of standard artifact property`</PropertyName>`<br />`<PropertyValue>`its new value`</PropertyValue>`<br />- Date format can be one of the following:<br />- `yyyy-mm-dd`<br />- `0` (the date of the property change)<br />- A non-zero integer that adds or subtracts the number of days from the current date (for example, "-7" is a week before the property change)<br />- Clears the property value if entered as an empty element<br />`(<PropertyValue />)`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ValidValues    | - one of these three properties (PropertyValue, ValidValues, UsersGroups) is required - only one instance of these properties can be used in any given `<PropertyChangeAction>` block in the XML | - Applies to the "choice" standard artifact type (single, or multi-choice)<br />- Replaces the existing set of choices<br />- Contains the following child-element structure:<br />`<ValidValue>` `<Value>`NewValue1`</Value>`  `</ValidValue>` `  <ValidValue>` `<Value>`NewValue2`</Value>` `</ValidValue>` `  <ValidValue>` `<Value>`NewValueN`</Value>` `</ValidValue>`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| UsersGroups    |                                                                                                                                                                                                  | - Applies to the "user" standard artifact type<br />- Updates a user-type property with the defined users, and instance- and project-level groups<br />- Contains the following child-element structure:<br />`<UserGroup>`<br />`<Name>`username`</Name>` `</UserGroup>`<br />`<UserGroup IsGroup="true">`<br />`<Name>`instance-level group name`</Name>`    <br />`<GroupProjectId>` `<UserGroup IsGroup="true">` <br />`<Name>`project-level group name`</Name>`   <br />`<GroupProjectId>`ProjectIDNumber`</GroupProjectId>` <br />`</UserGroup>`<br />`<UserGroup IsGroup="true">` `<Name>`project-level group name`</Name>` <br />`<GroupProjectPath>`Blueprint/folder/project1`</GroupProjectPath>` <br />`</UserGroup>`<br /><br />- When the `IsGroup="true"` attribute and value are used, the `Name` is interpreted as a group, not an individual user<br />- When the `IsGroup` attribute is used, and the `GroupProjectId` or `GroupProjectPath` child elements are also included, the `Name` is interpreted as a project-level user group; otherwise, it is an identically named instance-level group<br />- If the `IncludeCurrentUser="true"` attribute and value are included with the parent `UsersGroups` element, the current user (who has triggered the property change) is also included in the property change<br /><br />***Note: username declarations are case-sensitive*** |

# Triggered Action: Webhook Action

| **Properties**              | **Property Requirement** | **Notes**                                                                                                                                                                                                                                                                                                                      |
| --------------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| URL                         | Required                 | - The payload will be sent to this address if the action is triggered                                                                                                                                                                                                                                                          |
| IgnoreInvalidSSLCertificate | Optional                 | - False by default<br />- Controls whether the webhook should ignore an invalid SSL certificate<br />- Accepted values: **true** and **false**                                                                                                                                                                                 |
| HttpHeaders                 | Optional                 | - The call to the specified URL will include these headers<br />- Headers can be used to include additional information when sending the webhook<br />- Contains the following child-element structure:<br />`<HttpHeaders>`<br />`<Header>name1:value1</Header>`<br />`<Header>name2:value2</Header>`<br />`</HttpHeaders>`   |
| BasicAuth                   | Optional                 | - If a username and password are specified, they are included here<br />- Contains the following child-element structure:<br />`<BasicAuth>`<br />`<Username>admin-user</Username>`<br />`<Password>$ecr3tP@ssw0rd</Password>`<br />`</BasicAuth>`<br />- Must be listed before `<Signature>` if both elements are provided    |
| Signature                   | Optional                 | - Has two child elements: `<SecretToken>` (required) and `<Algorithm>` (optional)<br />- Accepted values for `<Algorithm>` are: **HMACSHA256&#x20;**&#x61;nd **HMACSHA1&#x20;**<br />- If `<Algorithm>` value not provided, defaults to **HMACSHA256**<br />- Must be listed after `<BasicAuth>` if both elements are provided |

# Triggered Action: GenerateActionType (value is "Children")

| **Properties** | **Property Requirement** | **Notes**                                                                                                                                                                                                                                                                   |
| -------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ChildCount     | Required                 | - The number of child artifacts that are created<br />- Contains the following child-element structure: `<GenerateActionType>Children</GenerateActionType>`<br />`<ChildCount>`number to create`</ChildCount>`<br />`<ArtifactType>`standard artifact type`</ArtifactType>` |
| ArtifactType   | Required                 | - The type of standard artifact that is automatically created                                                                                                                                                                                                               |

# Triggered Action: GenerateActionType (value is "TestCases")

| **Properties** | **Property Requirement** | **Notes**                                                                                   |
| -------------- | ------------------------ | ------------------------------------------------------------------------------------------- |
| --             | --                       | - Contains the following child element:`<GenerateActionType>TestCases</GenerateActionType>` |

# Triggered Action: GenerateActionType (value is "UserStories")

| **Properties** | **Property Requirement** | **Notes**                                                                                     |
| -------------- | ------------------------ | --------------------------------------------------------------------------------------------- |
| --             | --                       | - Contains the following child element:`<GenerateActionType>UserStories</GenerateActionType>` |

