--- sourceDocument: Brazil Build workflows sourceDocumentLink: https://www.servicenow.com/docs/r/build-workflows Release : - brazil ft:locale : - en-US ft:publication_title : - Brazil Build workflows ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # Submit Catalog Item Request action # Submit Catalog Item Request action {#ariaid-title1} Release version: Brazil Updated September 10, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Submit Catalog Item Request action The Submit Catalog Item Request action in ServiceNow enables the creation of a requested item (screqitem) within a Service Catalog Request (screquest) using Workflow Studio. This action is primarily designed for users with theflowdesigneroradminroles, allowing them to add this action to flows and configure its settings. Show full answer Show less ## Inputs This action accepts several inputs to specify the details of the catalog item request: * **Catalog Item:** Name of the requested catalog item. Depending on the item selected, additional inputs may dynamically appear (e.g., Preferred Email address for an email account request). * **Quantity:** Number of items requested. * **Special Instructions:** Text field for any specific instructions related to the request. * **Delivery Address:** Specifies where the requested item should be delivered. * **Requested For:** The user for whom the item is requested. * **Don't fail on error:** Option to control if the flow should continue despite errors in the action. * **Wait for Completion:** Option to make the flow wait until the request submission is complete before proceeding. * **Enable timeout:** When enabled alongside Wait for Completion, this limits how long the flow waits for completion before continuing. * **Duration:** Specifies how long to wait when timeout is enabled (hours, minutes, seconds). * **Schedule:** Defines the work schedule used to calculate timeout duration (e.g., business hours). **Note:** Certain Service Catalog variable types are not supported, including list collector lookup, multiple choice lookup, and select box. ## Outputs * **Error Message:** Displays any error message if the action fails. * **Requested Item:** Returns the Document ID of the created requested item. * **Status:** Numeric completion status of the action---0 for success, 1 for error, and 2 for timeout. ## Design Considerations * Escape quotation marks in string input variables using the String Replace transform function to avoid JSON formatting errors. * Use transform functions to validate data pills before passing them as inputs to ensure data integrity. ## Practical Application ServiceNow customers can use this action within flows to automate the submission of catalog item requests, enhancing efficiency and accuracy. The configurable options for timeout and error handling provide control over flow execution, ensuring robustness in process automation. Proper handling of input data with transform functions helps avoid errors related to data formatting. Create a requested item \[sc_req_item\] on a Service Catalog Request \[sc_request\]. ## Roles and availability {#submit-catalog-item-request-flow-designer__section_e1d_ggn_tkb} Available as a Workflow Studio ServiceNow core action. Users with the flow_designer or admin role can add an action to a flow and define configuration details. ## Inputs {#submit-catalog-item-request-flow-designer__section_imr_chn_tkb} {#submit-catalog-item-request-flow-designer__table_n5q_qhn_tkb__entry__2} | Input | Description | |-|-| | Catalog Item | Name of the requested catalog item. Extra inputs may be added dynamically, depending on which catalog item is selected. For example, when the requested catalog item is a new email account, a field for Preferred Email address appears. Note: The following Service Catalog variable types are not supported. * list collector * lookup multiple choice * lookup select box {#submit-catalog-item-request-flow-designer__ul_wsx_dpv_4qb} | | Quantity | Number of items requested. | | Special Instructions | Text describing any special instructions about the item request. | | Delivery Address | Location where the requested item should be delivered. | | Requested for | User that the item is requested for. | | Don't fail on error | Option to determine whether to fail the flow if the action produces an error. | | Wait for Completion | Option to force the flow to wait until the action has been completed before continuing. | | Enable timeout | Option to limit the amount of time that the flow waits for the action to be completed before continuing. Note: Use the Enable timeout option to prevent this action from continuing to run. If the condition to continue is never met, a timeout value specifies when the system skips the Wait for Condition action and go to the next item in the flow. You must set a Duration value to enable a timeout. You can also select a Schedule if you want to compute the duration end date based on a specific work schedule. This field appears only when the Wait for Completion option is selected. | | Duration | Amount of time that the flow waits before continuing when the Enable timeout option is selected. Enter the time to wait in hours, minutes, and seconds. If you leave this field empty, the flow does not wait. This field appears only when the Wait for Completion option is selected. | | Schedule | Schedule used to compute the timeout duration when the Enable timeout option is selected. For example, waiting for 10 hours as part of an 8-5 weekdays schedule causes the flow to wait for one or more business days. If you leave this field empty, the timeout runs without a schedule. This field appears only when the Wait for Completion option is selected. | [ ] {#submit-catalog-item-request-flow-designer__table_n5q_qhn_tkb} ## Output {#submit-catalog-item-request-flow-designer__section_j2j_2hn_tkb} {#submit-catalog-item-request-flow-designer__table_nb4_g3n_tkb__entry__3} | Field | Description | Data Type | |-|-|-| | Error Message | Message that displays if the action produces an error. | String | | Requested Item | Document ID for the requested item. | Document ID | | Status | The completion status of the action as a numeric value. * 0 (success) * 1 (error) * 2 (timeout) {#submit-catalog-item-request-flow-designer__ul_zjm_jt5_klb} | Choice | [ ] {#submit-catalog-item-request-flow-designer__table_nb4_g3n_tkb} ## Example {#submit-catalog-item-request-flow-designer__section_dxx_dhn_tkb} ## Design considerations {#submit-catalog-item-request-flow-designer__section_tvl_db4_45b} Follow these design considerations when creating flows that contain Submit a Catalog Item Request actions. Escape quotation marks from string data pills with the String Replace transform function : Complex string variables are converted into JSON format when stored in the system. To prevent any JSON formatting errors, you can use a Replace String transform function to escape the quotation marks present in any string data pills you use for catalog variables. See [String transform functions](https://www.servicenow.com/docs/34b497~fAGHWawoDLdJgNQ "Use string transform functions to reformat or perform calculations on String data pills."). Use transform functions to validate data pills : Whenever you use a data pill to provide data for an action input, you can use a transform function to validate the data. See [Transform functions](https://www.servicenow.com/docs/0yvUhOjz_OgF2QP6A9ygeA "Transform data pill values without the need to write a script. Use transform functions to reformat text, perform mathematical calculations, sanitize potentially unsafe SQL statements, and serialize complex objects to raw XML.") for a list of available transform functions.