With the Linear integration, you transfer projects and tickets from ZEP to Linear. ZEP is the leading system: data flows exclusively from ZEP to Linear – importing data from Linear into ZEP is not supported.
Data direction: ZEP → Linear
Product line availability
Note: The Linear interface is included in ZEP Track, ZEP Control, ZEP Operations, and ZEP Business.
Transferring tickets requires the ticket system. The Ticketing System can be added in ZEP Track, ZEP Control, ZEP Operations, and ZEP Business. It is booked via the ZEP Self-Service Tool under Administration > Account.
For setup and configuration, you need the Administration Area permission with Edit under Roles & Permissions. Administrators always have this permission.
Prerequisites
To set up the integration, you need:
Access to the Interface Marketplace in ZEP
A Linear account with sufficient permissions
Permission to create an OAuth2 app in Linear
The ability to authorize an OAuth2 connection in the browser
Setting up the integration
In ZEP, go to Administration > Interfaces > Interface Marketplace. Select Linear and click Configure.
Set up the connection in three steps:
Under OAuth2 Setup Instructions, ZEP shows the Callback URL (Redirect URI). Create an OAuth2 app in Linear and enter this URL there as the redirect URI.
Under Authentication Settings, enter the Client ID and Client Secret of the Linear app, and under Special settings enter the name of your Linear team in Team workspace name. Save.
Under Quick Actions, click Connect with OAuth2. You are redirected to Linear and grant ZEP one-time permission to transfer data.
Then define the following:
Synchronize data: With Sync Linear Projects and Sync Linear Issues, you choose what ZEP transfers to Linear. Both are active by default.
Configure status mapping: Define which ZEP ticket status corresponds to which Linear status. The mapping is stored in the integration settings.
Note: If a Linear status is deleted or renamed, update the status mapping in the integration settings to ensure synchronization continues correctly.
Data transfer
The integration transfers the following data from ZEP to Linear. ZEP tickets appear in Linear as issues.
Projects
ZEP transfers projects to Linear. The following is transferred:
Name of the project
Key (short designation)
Tickets
ZEP transfers ticket information to Linear. Changes to tickets in ZEP are automatically forwarded to Linear – keeping ticket information in Linear up to date when it is updated in ZEP.
Status mapping
In the field ZEP Status -> Linear Status, you assign the name of the matching Linear status to each ZEP ticket status. The field is empty by default. The following ZEP default statuses are available for mapping:
ZEP status | Linear status (example) |
New | New |
in process | In progress |
Done | Done |
Rejected | Rejected |
approved | Accepted |
accounted | accounted |
Synchronization and log
ZEP synchronizes the data hourly in the background. Projects and tickets are created in Linear on import and automatically updated when changed in ZEP.
ZEP is the leading system for all transferred data. Make changes to projects and tickets in ZEP.