Generates a link that automatically logs an Account into Duda.
Duda’s SSO link can be configured to send users to several different destinations within the platform. Valid target destinations include:
Duda Dashboard, Site Overview, SEO Overview, Store Management, Site Editor, Site Statistics, Site Reset (via Template, Simple Editor, or AI)
If you’re directing the user to any target besides the dashboard, you must include both the site_name and target parameters in the query string when generating the SSO link.
This API is supported for both CUSTOMER and STAFF account types.
| Target Location | Query Key | Query Value | Description |
|---|---|---|---|
| Dashboard | (none) | (none) | Send the user directly to their website dashboard. You do not need to send a target or site_name parameter. |
| Site Editor | target | EDITOR | Send the user directly to the white labeled website builder. |
| Template Chooser | target | RESET_SITE | Send the user directly to select a new template / reset site page. If the user does reset the site, all existing website edits will be lost and the site will be reset to a new template that is selected. |
| Template Chooser | target | SWITCH_TEMPLATE | Send the user directly to select new a template without resetting the site. This will retain all site data and installed apps. When implementing aDIY Flow it is highly recommended to use this target and not RESET_SITE. |
| AI Builder | target | SWITCH_TEMPLATE_WITH_AI | Send the user to the AI site builder. Classic sites are not supported with the AI builder and the original site should be created from an Editor 2.0 template. User must have the AI_ASSISTANT, EDIT and RESET permission. |
| Simple Editor | target | RESET_BASIC | Send the user directly to the simple editor to build or maintain their site. (note: the simple editor is an add-on and may not be available on all accounts) |
| Store Management | target | STORE_MANAGEMENT | Send the user directly to the Store Management area within the site editor. |
| Site Overview | target | SITE_OVERVIEW | Send user to the site overview in the dashboard to view stats, permissions and more. |
| Stats | target | STATS | Send the user directly to the website statistics page. |
| SEO Overview | target | SITE_SEO_OVERVIEW | Send the user to the SEO overview card within the site overview. User must have the SEO_OVERVIEW permission. |
SSO Links should be generated on demand and should not be generated upon page load or be statically linked to. SSO Tokens are only valid for two minutes, so you need to verify in real time that the user is authenticated to your system, then generate the SSO link once they intend to enter the editor, dashboard, stats, etc..