Installation guide for the Magicline Connector app

The setup for the Magicline App is slightly more complex compared to other Leafworks Apps. This is mainly due to the need to securely retrieve and map each studio's Studio ID with its corresponding secured API key.

Our primary goal is to ensure a secure, frontend-based setup. Like all Leafworks Apps, the Magicline App runs entirely on the UI, ensuring full GDPR compliance.

❗ Need help with the setup? app-support@leafworks.de or via our contact form — we're happy to assist. Please note that additional setup fees may apply. ❗

1.  Prepare Zendesk Configuration in the Admin Center

Before you begin mapping Studio IDs and API keys, make sure you

• Add your Magicline tenant to the app.

• Create a custom user field to link customers.

2. Map Studio IDs to API Keys

You need to map each Studio ID to its corresponding Magicline API key. 

• • Studio IDs must be retrieved directly from your Magicline environment.

  • API keys must also be generated with the appropriate permissions from within Magicline.

Use the following format to define your mapping in JSON. Each line maps a Studio ID to a secure API key identifier.

3. Add API Keys

Below the JSON input field, enter each API key in its corresponding line.This added step is a security measure to ensure the keys are stored securely and never exposed directly in the configuration.

❗ Need help with the setup? app-support@leafworks.de or via our contact form — we're happy to assist. Please note that additional setup fees may apply.❗

Set role and group restrictions

Define roles and groups within your Zendesk environment (e.g., Admins, Billing Admins) for better role-based control and visibility.

Need help?

If you have any questions or suggestions related to this app, please get in touch with us at app-support@leafworks.de or via our contact form.