Engage Request Deep Links
You can configure the following fields in the Engage Request Deep Link, which launches and Engage Request in Legl with these query parameters:
Parameter | Required | Description |
createmodal_show | Yes | If this equals true or True the modal will be displayed on page load |
createmodal_email | Yes | Sets the Email Address field. |
createmodal_first_name | Yes | Sets the First Name field |
createmodal_middle_name | No | sets the Middle Names field |
createmodal_last_name | Yes | sets the Last Name field |
createmodal_client_reference | No | Sets the Client Reference field |
createmodal_matter_reference | No | Sets the Matter Reference field |
provider | No | Should be set to the name of the platform you are launching the deep link from (if any) |
The below example incorporates these fields into HTML which will take the user into Legl, prompting them to authenticate and launching the Engage request in the screenshot below.
https://account.legl.com/engage/?createmodal_show=true&[email protected]&createmodal_first_name=John&createmodal_last_name=Doe&createmodal_matter_reference=MR50&createmodal_client_reference=CR22&provider=microsoftteams
In-Person CDD Deep Links
In-person CDD deep links let you open the manual CDD drawer directly from an external system (e.g. a Practice Management System) with contact and matter data pre-populated.
The URL format follows the same pattern as Engage Request deep links, using createmodal_* query parameters on the /engage/ page. The key difference is the value of createmodal_show — set it to in_person_cdd instead of True.
Base URL
Replace account.legl.com with your firm's Legl domain.
Available parameters
Parameter | Description | Required |
| Must be set to | Yes |
| Contact's first name | No |
| Contact's last name | No |
| Contact's email address | No |
| Client reference / participant ID | No |
| Matter reference / action ID | No |
| Reviewer's Legl lawyer ID (pre-selects the reviewer dropdown) | No |
| Note for the assigned reviewer | No |
Only createmodal_show=in_person_cdd is required. All other parameters are optional — any fields not provided will be left blank for the user to fill in manually.
Example link
https://account.legl.com/engage/?createmodal_show=in_person_cdd&createmodal_first_name=Jane&createmodal_last_name=Doe&[email protected]&createmodal_matter_reference=MAT-001&createmodal_client_reference=CL-1234&createmodal_reviewer=4480&createmodal_note=Please review urgently
Example link (with Actionstep merge fields)
https://account.legl.com/engage/?createmodal_show=in_person_cdd&createmodal_first_name=[[FirstName|pt=Client|rn=*]]&createmodal_last_name=[[LastName|pt=Client|rn=]]&createmodal_email=[[E_mail|pt=Client|rn=]]&createmodal_matter_reference=[[Action_ID]]&createmodal_client_reference=[[ParticipantID|pt=Client|rn=*]]
Business Search Deep Links
You can configure the following fields in the Business Search Deep Link, which launches company search in Legl with these query parameters:
Parameter | Required | Description |
search | Yes | Name of the Company to be searched, or regNo depending on the searchType |
country | Yes | Alpha-2 Country code for region to be searched. Bear in mind that certain jurisdictions may have limited corporate data available, which will be flagged to the user when they enter Legl |
searchType | Yes | Enum, can be ‘name’ or ‘regNo’. ‘name’ will search for the company name. |
provider | No | Should be set to the name of the platform you are launching the deep link from (if any) |
The following example searches for Lidl in the United Kingdom by name:
https://account.legl.com/businesses/search?search=Lidl&country=GB&searchType=name&provider=microsoftteams
The following example searches for Company Number 02816429 in the United Kingdom by regNo:
https://account.legl.com/businesses/search?search=02816429&country=GB&searchType=regNo&provider=actionstep
Pay Checkout Links
A payment can be initiated into a customer’s Legl instance at any time, with the following query parameters available. These are the same links used in Payment Portals, but can specify the amount to be paid, and the customer's details. Unlike Deep Links, they require no authentication - anyone can make a payment via these links:
Parameter | Required | Description |
i | Yes | Invoice reference e.g. 22 |
m | Yes | Matter reference e.g. 1671 |
a | Yes | The amount to be paid. Accepts a float with up to 2 decimal points. Numbers passed in after the second decimal point will be rounded. |
provider | No | Should be set to the name of the platform you are launching the deep link from (if any) |
For example, the following URL takes a customer through to the following screen where they can complete their Payment:
The leglco.sandbox portion of the query parameter will be replaced by the company name of the customer being configured, for example if this was Microsoft , the URL might be:
The specific moniker to use can be found by finding your Payment portal checkout link under Settings —> Bank Accounts: