Guides
System StatusRaise a TicketZluri Website

Troubleshooting

This page contains a list of common errors and known issues encountered while integrating Zeplin with Zluri, and instructions on how to fix them.

If your issue isn’t mentioned here, feel free to submit a ticket or contact us directly at [email protected].

ZEP-100-A: The token used to connect the integration is invalid or has been expired. Please ensure that you use the right token to connect the integration

When does this error occur?

  • While connecting Zeplin to Zluri with an invalid or expired access token.

How to resolve:

  1. Generate a new access token:

    • Log into your Zeplin account
    • Navigate to Settings → Developer
    • Create a new Personal Access Token or OAuth Application
    • Copy the new token immediately (it won't be shown again)

  2. Verify token permissions:

    • Ensure the token has sufficient permissions to access your organizations
    • Check that the token hasn't been revoked or expired

  3. Reconnect the integration:

    • Use the new token when connecting Zeplin to Zluri
    • Follow the connection steps in the integration guide

ZEP-100-B: The token used to connect this integration is expired/revoked. Generate a new token and reconnect the integration

When does this error occur?

  • During data synchronization when the previously connected token has expired or been revoked.

How to resolve:

  1. Check token status:

    • Verify if the token is still active in your Zeplin account
    • Check if the token was accidentally revoked or expired

  2. Generate a new token:

    • Log into your Zeplin account
    • Navigate to Settings → Developer
    • Generate a new Personal Access Token
    • Ensure the token has the necessary permissions

  3. Reconnect the integration:

    • Use the new token to reconnect Zeplin to Zluri
    • Test the connection to ensure it's working properly

ZEP-101-A: The user trying to connect the integration does not have sufficient permissions. Modify the user permission and try again

When does this error occur?

  • When the user attempting to connect Zeplin to Zluri lacks the necessary permissions to access organization data.

How to resolve:

  1. Check user role:

    • Ensure you have administrative or owner permissions in your Zeplin organizations
    • Verify that your account can access organization settings and member data

  2. Update permissions:

    • Contact your Zeplin organization administrator to grant you the necessary permissions
    • Ensure you have at least Editor or Admin role in the organizations you want to sync

  3. Alternative solution:

    • Use a different user account with appropriate administrative privileges
    • Consider having an organization owner perform the integration setup

After updating permissions, try connecting the integration again.

ZEP-101-B: The permission for the user who connected the integration is modified/revoked. Modify the user permission and reconnect the integration

When does this error occur?

  • During data synchronization when the user who originally connected the integration has lost the required permissions.

How to resolve:

  1. Restore user permissions:

    • Contact your Zeplin organization administrator to restore the necessary permissions
    • Ensure the user has Editor or Admin role in all relevant organizations

  2. Check account status:

    • Verify that the user account is still active and hasn't been removed from organizations
    • Ensure the account hasn't been downgraded or restricted

  3. Reconnect if necessary:

    • After restoring permissions, test the integration
    • If issues persist, reconnect the integration using the same user account or a different user with appropriate privileges

ZEP-102-A: The user trying to connect the integration does not have sufficient permissions. Modify the user permission and try again

When does this error occur?

  • When the user attempting to connect lacks specific permissions to access organization member data in Zeplin.

How to resolve:

  1. Verify member access permissions:

    • Ensure your user account can view and access organization members
    • Check that you have permissions to read member lists in all organizations

  2. Update organization roles:

    • Contact your Zeplin organization administrator
    • Request Admin or Owner permissions to access member data
    • Ensure you're a member of all organizations you want to sync

  3. Test member access:

    • Try accessing the "Members" section in your Zeplin organization settings
    • Verify you can see the list of organization members

After updating permissions, try connecting the integration again.

ZEP-102-B: The permission for the user who connected the integration is modified/revoked. Modify the user permission and reconnect the integration

When does this error occur?

  • During data synchronization when the user has lost specific permissions to access organization member data.

How to resolve:

  1. Restore member access permissions:

    • Contact your Zeplin organization administrator
    • Request restoration of permissions to access organization members
    • Ensure you maintain Admin or Owner role in relevant organizations

  2. Verify organization membership:

    • Check that you're still a member of all organizations being synced
    • Ensure your role hasn't been downgraded to a level that restricts member access

  3. Test and reconnect:

    • Test access to organization member lists in Zeplin
    • If issues persist, reconnect the integration with updated permissions

ZEP-103-A: The user trying to connect does not have any organization

When does this error occur?

  • When attempting to connect Zeplin to Zluri with a user account that is not associated with any Zeplin organizations.

How to resolve:

  1. Join an organization:

    • Contact your team administrator to be added to a Zeplin organization
    • Accept any pending organization invitations in your email or Zeplin notifications

  2. Create an organization:

    • If you need to create a new organization, go to Zeplin and create one
    • Ensure you have the necessary permissions in the organization

  3. Verify organization access:

    • Log into Zeplin and confirm you can see at least one organization
    • Ensure you have appropriate permissions within the organization

After joining or creating an organization, try connecting the integration again.

ZEP-103-B: The user trying to connect does not have any organization

When does this error occur?

  • During data synchronization when the user has been removed from all Zeplin organizations.

How to resolve:

  1. Check organization membership:

    • Verify if you're still a member of the organizations that were previously connected
    • Check if you were accidentally removed from organizations

  2. Rejoin organizations:

    • Contact organization administrators to be re-added to the necessary organizations
    • Accept any new organization invitations

  3. Reconnect the integration:

    • After rejoining organizations, reconnect the Zeplin integration
    • Ensure you have the appropriate permissions in the organizations

ZEP-104-A: The user trying to connect the integration does not have sufficient permissions. Modify the user permission and try again

When does this error occur?

  • When the user can access organizations but cannot read member information from any of them.

How to resolve:

  1. Check member reading permissions:

    • Verify that you can access the "Members" section in at least one organization
    • Ensure your role allows you to view organization member lists

  2. Request elevated permissions:

    • Contact organization administrators to grant you Admin or Owner permissions
    • Ensure you have member management or viewing permissions

  3. Verify in multiple organizations:

    • If you're a member of multiple organizations, ensure you have appropriate permissions in at least one
    • Focus on organizations where you have the highest level of access

After obtaining the necessary permissions, try connecting the integration again.

ZEP-104-B: The permission for the user who connected the integration is modified/revoked. Modify the user permission and reconnect the integration

When does this error occur?

  • During data synchronization when the user has lost permissions to read member information from all organizations.

How to resolve:

  1. Restore member access:

    • Contact administrators of your Zeplin organizations
    • Request restoration of permissions to view organization members
    • Ensure you have at least Admin role in one organization

  2. Check role changes:

    • Verify if your role was changed across all organizations
    • Ensure you still have access to member management features

  3. Test and reconnect:

    • Try accessing member lists in your Zeplin organizations
    • After restoring permissions, test the integration or reconnect if necessary

If your issue is not listed here, please contact Zluri support with the error details for further assistance.

Updated about 1 month ago