To successfully create an application with Works with Legrand, follow this step-by-step tutorial. Before you begin, be sure to complete the Getting Started tutorial, where you’ll get your LEGRAND developer account, a subscription key, and learn how to explore APIs.

Step 1 : Register your application

To use our APIs, first register your application to obtain its unique set of credentials, which will be used by your users to enable your app to access their data. 1. Go to My Applications, a page dedicated to application management.

2. Then click on “Request New Application” and fill all followings fields:

Fields Name, Description, Vendor and Select a logo will be displayed to end-user when he will give the consent for the application to access to his data.
Url field corresponds to the web site where users can learn more about your application


3. Once done, click on “Next Page” button and insert your Reply Url. You can add up to 10 different endpoints with the “Add new reply URL” button

Reply Url field redirect users back to your application during the authorization process. This corresponds to Oauth2 standard flow.


When your application requests authorization to access a user’s data, it includes a redirect_uri parameter in its query string. To authorize your application, this value must match EXACTLY  the URL you have provided in the Reply Url field, including any trailing slashes.

Step 2 : Check scopes

Before validating the application, you also need to specify which scope you need to use with your application:

Required scopes are  detailed in each API description

Click on “Next Page” and verify if all information are correct. Finally, click on “Validate” to create your application

Step 3 : Getting application details

After the creation of your application you are redirected to its details where you will find your client_id and client_secret. An email with these information will also be sent to you


You absolutely need to keep the generated client_secret value. It CANNOT BE SENT BACK TO YOU


If needed, you can generate a new client_secret value and delete old ones