The connector reads one Zammad instance. It syncs that instance’s users,
groups, and roles, along with each group’s membership and each user’s role
assignments. Users sync as enabled or disabled based on their active state
in Zammad.A user’s per-group access levels (such as read, create, or full) and a
role’s group access map are carried on the user and role profiles for
visibility, but the individual access levels are not modeled as separate
access.
You need an admin agent account on your Zammad instance to create the API
token. Tokens created by customer accounts cannot list other users and do
not work with this connector.
1
Sign in to your Zammad instance with an admin agent account.
2
Make sure API token access is enabled on the instance: in the admin
area, check Settings > System > API and turn on API
Token Access if it is off.
3
Open your avatar menu and go to Profile > Token Access. Create
a new personal access token with permission to read users, groups, and
roles (the admin or admin.user, admin.group, and
admin.role permissions cover this).
4
Copy the token when it is shown — Zammad displays it only once — and
note your instance’s API base URL. It is your Zammad address with the
/api/v1 path appended, for example
https://mycompany.zammad.com/api/v1.
Follow these instructions to use a built-in, no-code connector hosted by C1.
1
In C1, navigate to Integrations > Connectors and click Add connector.
2
Search for Zammad and click Add.
3
Choose how to set up the new Zammad connector.
4
Set the owner for this connector.
5
Click Next.
6
Find the Settings area of the page and click Edit.
7
Enter the Zammad credentials:
Zammad API base URL: your instance’s full API address,
including the /api/v1 path, with no trailing slash. For
example, https://mycompany.zammad.com/api/v1.
API token: the access token created from your admin agent
profile.
8
Click Save.
9
The connector’s label changes to Syncing, followed by Connected. You can view the logs to ensure that information is syncing.
Done. Your Zammad connector is now pulling access data into C1.
Follow these instructions to run the Zammad connector in your own
environment.
1
Create secrets for the Zammad credentials.
2
Configure the connector environment variables:
BATON_ZAMMAD_BASE_URL: your instance’s full API address,
including the /api/v1 path, with no trailing slash. For
example, https://mycompany.zammad.com/api/v1.
BATON_ZAMMAD_API_TOKEN: the access token created from your
admin agent profile.
3
Deploy the connector using your standard self-hosted connector process.
Done. Your Zammad connector is now pulling access data into C1.
