Skip to content

DocsUsing the workspace

Connect your first project

Create a customer, register a project against your error tracker, and pull in real issues.

Projects are grouped under customers, so agencies and internal teams can both keep things tidy. Even for a single application you create one customer first.

Get a token from your error tracker

Before you start, collect three values from the tracker your application reports to:

ValueWhere to find it
Base URLThe address you use to open the tracker, for example https://errors.yourcompany.com
Auth tokenUser settings → Auth tokens → create a token with read access
Organisation and project slugThe two path segments in the URL when you view the project

Create the customer and project

  1. Open Customers and create one — a company name is fine.
  2. Open Projects → New project.
  3. Fill in the customer, a project name, and the environment (production, staging, or development). Environment matters: production incidents score higher.
  4. Paste the base URL, auth token, organisation slug, and project slug.
  5. Press Verify connection. Do not skip this — it checks the token and both slugs before anything is saved.
  6. Add the email addresses that should receive alerts, and choose which risk levels may notify.
  7. Press Create project.
Slugs are case-sensitive. A verification failure is almost always a slug typo or a token without read access.

Pull in the existing issues

Open the project and press Sync now. The first sync fetches current issues, creates one incident record per issue, and queues each new one for analysis.

After the first sync, a scheduled job pulls new issues every five minutes. You do not need to press anything again.

What you should see

Within a minute or two, issues appear under Issues with a risk level beside them. A blank list means the tracker has no open issues in that project, which is a good problem to have.