Get SharePoint URL

Use this step to get the SharePoint document HTTP URL.

Last published at: September 10th, 2025

spGetHttpUrl Step

Description:

The Get SharePoint URL workflow step retrieves the HTTP URL for a SharePoint site based on its title.

The step supports:

  • Specifying the BaseURL for the SharePoint site.
  • Selecting an OAuth provider.
  • Providing the SharePoint site title used to retrieve the HTTP URL.
  • Storing the returned result in a FlowWright Variable or Global.
  • Routing the workflow through True or False return paths.

This step can be used for:

  • SharePoint site URL retrieval
  • Dynamic SharePoint integration
  • Building links to SharePoint sites
  • Generating notifications containing SharePoint links
  • Creating dynamic document-management workflows
  • Passing SharePoint URLs to subsequent workflow steps
  • Workflow-driven SharePoint navigation

The XML defines the step as a SharePoint process step named spgethttpurl, with the display name Get SharePoint URL, and the label Gets the SharePoint HTTP URL. It is implemented by FlowWright.Workflow.dll in the FlowWright.Workflow.SpGetHttpURL namespace.

 

Inputs

  • BaseURL – Specifies the BaseURL for the SharePoint site.
  • selOAuthProvider - Selects the OAuth provider used for the SharePoint operation. 
  • spTitleName – Specifies the SharePoint site title used to retrieve its HTTP URL.
  • resultJson – Specifies the FlowWright Variable or Global used to store the returned result.
 

 

Returns

  • True – Step executed successfully
  • False – Step failed to execute 
 

 

Usage:

The Get SharePoint URL step is typically placed after the workflow has determined which SharePoint site it needs to reference.

The workflow can dynamically provide the SharePoint site title using Variables, Globals, form values, previous workflow outputs, or information retrieved from external systems.

The returned URL can then be used by subsequent workflow steps to:

  • Build hyperlinks.
  • Populate Variables or Globals.
  • Send SharePoint links in notifications.
  • Create links in generated documents.
  • Provide users with navigation to a SharePoint site.
  • Pass SharePoint location information to another integration.

A typical workflow can be structured as:

Start
 │
 ▼
Determine Project Site
 │
 ▼
Get SharePoint URL
 │
 ├──► True ──► Build Project Link
 │                   │
 │                   ▼
 │              Send Notification
 │
 └──► False ──► Handle Failure

 

 

This follows the same workflow-oriented usage pattern as the reference documentation, where information produced by a step is stored and subsequently consumed by later workflow activities.

 

When the workflow reaches the Get SharePoint URL step, the configured SharePoint information and site title are used to obtain the SharePoint HTTP URL. The returned result is stored in the configured Variable or Global.

 

Example:

Let’s build and execute the “spGetHttpURLDef” example.          

  • Create a new definition called “spGetHttpURLDef" and open it in Designer mode. 
  • Drag a “spGetHttpURL” step to the canvas.
  • Connect the dots between the “Start” and “spGetHttpURL” steps, as shown above. 
  • Select the line between the steps to configure the “Connection Properties”. The default property values are “None, Error, and Evaluate”. Depending on the step’s purpose, additional values are available for configuration.
  • Define a variable or a global to store the result. 
  • Click the "spGetHttpURL" step to configure its "Required" properties. Provide a name for the step. Select the OAuth provider from the connection menu. Provide a title to retrieve the SharePoint site's HTTP URL. Assign the result to a variable or a global variable. Click the Save button. Note: Click the "AI Predict" button for the Copilot to add new process steps that match your process description. 

 

  • The “Logging” configuration is necessary for documentation and also measures workflow progress and percent complete. This is achieved by configuring the step state and percent fields individually, as shown in the images below. Configure the “Logging” using the following properties.

 

  • Save the process definition, create a new instance, and execute it. Render the process instance. Click the process step to view its properties. The step should retrieve the HTTP URL for the SharePoint site.

 

Tips:

  • Verify the SharePoint BaseURL before executing the workflow.
  • Select the correct OAuth provider.
  • Verify that the supplied site title corresponds to the intended SharePoint site.
  • Use a Variable or Global when the SharePoint site title is determined dynamically.
  • Store the returned result in a clearly named Variable or Global, such as SharePointURL.
  • Use the True path to continue processing after a successful URL lookup.
  • Use the False path for appropriate error handling.
  • Test SharePoint authentication and site title configuration before deploying the workflow.
  • If the returned URL will be used in notifications or generated documents, validate the stored result before using it downstream.
  • Keep SharePoint site naming conventions consistent if site titles are supplied dynamically.
  • Test representative site titles before deploying a workflow that performs dynamic SharePoint URL lookups.
  • The XML does not define the exact format of the returned result, so verify the result structure against the FlowWright SharePoint implementation.

 

Notes:

  • The step belongs to the SharePoint category. 
  • The display name is Get SharePoint URL. 
  • The step name is spgethttpurl. 
  • The step label is Gets the SharePoint HTTP URL. 
  • The namespace is FlowWright.Workflow.SpGetHttpURL. 
  • The step is implemented by FlowWright.Workflow.dll. 
  • The step is defined as a Process step.
  • The definition specifies two input connections and two output connections. 
  • BaseURL is required.
  • Select OAuth provider is required.
  • Enter your title to get the SharePoint site HTTP URL.
  • Storing the result in a Variable/Global is required. 
  • The OAuth provider uses the SelOAuthProvider data type. 
  • The string properties use the FlowWright.DataTypes.ClsTextBox implementation. 
  • The step provides True and False return values. 
  • The XML does not specify the exact behavior of the SharePoint site title lookup.
  • The XML does not specify the exact structure of the result stored in the configured Variable or Global.
  • The XML does not specify the runtime conditions that produce the True or False result.
  • The XML does not document handling of authentication failures, SharePoint API errors, retries, timeouts, or cancellation behavior.

 

A useful pattern for the Get SharePoint URL step is to separate site identification, URL retrieval, URL storage, and downstream use.

This pattern makes it clear that the workflow first identifies the required SharePoint site and then retrieves its URL before using the result elsewhere.

 

Definition Sample:

You may download the sample definition(s) from the link here and later import them (drag-and-drop) to your FlowWright Process Definition (XML file) or Form Definition (HTML file) page.

Note: Please verify and complete the process steps for any missing configurations, such as file path references and database connections, after the import. Then, save the definition to confirm the changes.

Click here to download the sample file.