What you'll need
- Admin access to your Dozuki site, with API access enabled
- An API key and the Dozuki account Maestro will publish as
- Your Dozuki site URL and site name
- Around 10–15 minutes to complete the setup
Overview
The Dozuki connector publishes standardized work instructions from Maestro into your Dozuki site as structured guides, with steps, tools and safety notes carried across.
What this connector does
- Creates structured guides in Dozuki
- Organizes content into your categories
- Maintains step-by-step formatting
- Uploads step images alongside the text
What gets exported
- Sequential step instructions
- Tool and material requirements
- Safety considerations
- Guide metadata and tagging
Step-by-step setup
Prepare your Dozuki account
Make sure your Dozuki site is ready to receive published instructions.
Verify account access
- Sign in to your Dozuki site as an administrator.
- Under Admin → Site Settings, confirm API access is enabled for your site.
- Note your site URL, e.g.
https://yourcompany.dozuki.com.
Create categories (optional)
- Go to Admin → Categories.
- Create categories such as "Work Instructions", "Safety Procedures" or "Equipment Maintenance".
- Set the permissions you want on each.
Well-organized categories make published instructions far easier for your team to find in Dozuki.
Gather your API credentials
Maestro signs in to Dozuki as a real user and presents an API key alongside it, so you need both.
What to collect
| Credential | What it is |
|---|---|
| API key | Issued by Dozuki for your site — see their API documentation if you don't have one |
| Username | The email address of the Dozuki account Maestro will publish as |
| Password | That account's password |
Confirm the account can create guides in the categories you intend to publish into — Maestro can only do what that user is allowed to do.
Use a dedicated service account
Maestro stores these credentials to authenticate on every publish, so prefer a purpose-made Dozuki account over someone's personal login. It keeps published guides attributed to Maestro, and it means nobody's password change breaks the connector.
Configure the connector in Maestro
Open connector settings
- In Maestro, go to Organization → Connectors.
- Find Dozuki and click Connect.
Enter configuration details
| Field | Value | Where to find it |
|---|---|---|
| Site URL | Your Dozuki site, including any custom domain | The address you sign in at |
| Site Name | Your Dozuki site's name | Admin → Site Settings |
| API Key | The key for your site | Collected in Step 2 |
| Username | The account Maestro publishes as | Collected in Step 2 |
| Password | That account's password | Collected in Step 2 |
Click Test connection, verify it succeeds, then Save connector.
Troubleshooting
If the test fails, check the site URL first — it must be the full address of your site, and API access has to be enabled on it (Step 1).
Publish a test instruction
Send from Maestro
- Open a standardized work instruction in your Library.
- Choose Send, select Dozuki as the destination, and confirm.
- Follow the job in Activity until it finishes.
Verify in Dozuki
- Open your Dozuki site and find the new guide in its category.
- Confirm the steps, tools and safety notes all came across.
Success
Your instruction is live in Dozuki as a structured guide. Published guides also sync back into your Library, so you can see what's already out there.
Troubleshooting
Connection failed
Check the site URL is correct and that API access is enabled for your site.
Because Maestro signs in as a real user, a connection test also fails when the username or password is wrong, or when that account's password has since changed. Re-enter the credentials and test again.
Publishing errors
Usually the account Maestro publishes as can't write where you're asking it to. Check the category's permissions in Dozuki for that user.
Otherwise, confirm the instruction's required fields are populated and that it doesn't exceed Dozuki's size limits.
Missing content or images
Check the job in Activity for the specific error, and confirm your media is in a format Dozuki accepts.
Maestro splits long steps to fit Dozuki's per-step limits, so a step may arrive as two — that's expected, not lost content.
Next steps
Organize your categories
Set your Dozuki categories up to match how your team actually looks for work instructions, before you publish in bulk.
Train your team
Show your team how to send instructions to Dozuki and how to find them in both systems once they're live.
Need more help?
If your issue isn't covered here, reach out with your setup details and any error messages you're seeing.