FAQ

General

What is the Works with Legrand program?

Works with Legrand is an open interoperable platform, a strategic part of Eliot, the Legrand innovative program dedicated to promoting the design and deployment of Legrand connected devices. The program allows the Legrand ecosystem to be compatible with major IoT global players. Works with Legrand, thanks to important partnerships, breaks boundaries enabling other companies to connect their devices or services with Legrand products.

Why could I be interested in this program?

The program is an open approach to enable innovation for living and working spaces; if you are integrating our solutions or if you want to enable services based on data coming from Legrand devices, this is the right place. Develop your solution and start to be part of our community!

How can my company become part of Legrand's partners?

You can consume Legrand APIs free of charge, after the sign-in, but with some limitations on the number of calls. If you want to become part of our connections or if you need to increase the number of permitted calls, you need to go in the Contact page and send us an email. We will receive your request and we will contact you as soon as possible!

I've developed a solution. How can I be part of the solution showcase?

Thanks to be part of our community! You can share your solution with us using the Contact page and send us an email. Fill in all the request and we will contact you as soon as possible

How can I access the forum?

Your developer account can also be used on the forum. Sign-In and go in Documentation > Works with Legrand > Forum in the menu. You can manage your personal information in “My Profile” menu. Then, click on the pen icon

Account management

How can I register an account?

In order to access to data concerning the APIs, you need to create an account. Go on the Sign Up page
If you are a third party developer / partner, you have to click on the Sign Up of “You are developer?” and start filling all the form.

If you are an internal developer, choose the Legrand’s Sign in

How can I change my credentials?

To change your credential (email, First name and Surname, Display name for forum, …) you first need to Sign In. Go to “MY PROFILE” menu and click on the pen icon

You will be redirected and asked to sign in one more time
Finally, change the fields you want and click on “Confirm” button

Troubleshooting

Why there is a Primary key and a Secondary key in my subscription?

Both keys are usable, and only one key is needed at a time. Thanks to these 2 keys, you can change a key without down time of your application. For example, if you want to replace your primary key, the procedure is :

Configure your application to use the secondary key;
Deploy it to your customers;
Regenerate the primary key;
(optional) reconfigure your application to use the new primary key

What are user consents? Can it be revoked?

It is mandatory for users to accept the scopes defined in your application in order to use it. Users can revoke the consents they gave on a specific application from a Legrand app. This revokation process must not be implemented by third party applications

What happen if the user refuse the consents?

The user will have to consent on all the scopes provided during the application registration step. The user has 2 options:

Accept all scopes: in this case, Legrand authentication will resume and redirection to the reply URL will be made
Deny: if the user denies, he will not be connected, so he will have to log in again and consent on the scopes to access the application. Moreover, he will be redirected to the redirect_uri with two parameters in query string :

error: access_denied
error_description: Access denied by user

What happens if I change the scopes required in my application?

You changed the scopes required by your application and this change has been approved. Then, the authentication will not be allowed as long as the scopes required on the previous refresh_token are different from the scopes currently existing on the application. You will need to ask for a new authentication with the grant_type “authorization_code”, so the user can give his consent on the new provided scopes

How can I retrieve my plantId, moduleId and ambientId?

To find the plantId

Sign up with your Works with Legrand account. You must have subscribed to the Starter Kit
Go on the menu Documentation > Works with Legrand > LIST OF APIs, click on “APIs” and choose the Smarther API or Home + Control API
On the left, click on “GET Plants” for the Smarther or “GET Get users’ plants” for Home + Control. Then click on the “Try it” button on the right
In Authorization section, choose “Authorization code” for ELIOT – Azure AD B2C – OpenID Connect for the Smarther or OAuth Server for Try it Eliot API for Home + Control. If you are logged in, other information are already filled up
A popup will be opened. Fill the information and validate
Click on “Send” button and retrieve the ID of the plant in the Response content

To find the moduleId and ambientId

Sign up with your Works with Legrand account. You must have subscribed to the Starter Kit
Go on the menu Documentation > Works with Legrand > LIST OF APIs, click on “APIs” and choose the Smarther API or Home + Control API
On the left, click on “GET Topology” for the Smarther or “GET Get plant’s topology” for Home + Control. Then click on the “Try it” button on the right
In the Query parameters, fill in the “plantId” field
In Authorization section, choose “Authorization code” for ELIOT – Azure AD B2C – OpenID Connect for the Smarther or “Authorization code” for OAuth Server for Try it Eliot API for Home + Control. If you are logged in, other information are already filled up
Click on “Send” button and retrieve the IDs of the modules and the ambient (only for Home + Control) in the Response content

How can I associate my Smarther or C300X13E account to my WWL account?

First, if you don’t have a Legrand account you need to create one on Works with Legrand and to subscribe to the Starter Kit
You must also have downloaded the Thermostat or Door Entry application and to have created an other account (you can use the same Email/Password as previously)
On the left side menu, click on “Account” and then on “Third-party access”
Sign-in by using your Legrand credentials
A message will appear to confirm the connection. You can now use the APIs
To use the “Try it”, you need to enter your Legrand credentials

I didn’t receive my client_secret. What can I do?

After validation of your application, you receive the needed client_secret by email. You can check in “MY APPLICATIONS” menu the status of your request. If you can’t find this email in your regular box, please check your spam folder. If you use Gmail, this email can arrive in “Promotions” tab. If you still can’t find this email, please write us a message via the contact form with your Application ID

You didn't find an answer to your question ?