Connecting your Backlog space
Connect your Backlog space so Chronigami can read projects and write issues and hours.
Chronigami talks to Backlog through a connected space. One Backlog space can belong to only one Chronigami workspace. Connecting does not choose which Backlog projects you use; Time tracking and Portal pick projects later in their own screens.
What you need
- A Chronigami admin account in the workspace
- A Backlog account that is Administrator of that space (in Backlog's role terms—not only Project Administrator)
- The space id and domain (for example
acmeon.backlog.com)
Supported Backlog domains in the Chronigami app: backlog.com, backlog.jp, and backlogtool.com.
Start the connection
You can start from Home or Workspace settings.
From Home
- Open Home.
- Under Set up your workspace, open Connect a Backlog space.
From Workspace settings
- Open the account menu → Workspace settings (page title Workspace settings).
- Open the General tab.
- Under Connected spaces, select Connect a Backlog space.
On the Backlog connection page
- Confirm the page title is Connect a Backlog space.
- Enter Space id (the host prefix, such as
acmeforacme.backlog.com). - Choose Domain (
.backlog.com,.backlog.jp, or.backlogtool.com). - Select Continue.
- Backlog opens so you can approve access. The helper text is: You'll be sent to your Backlog space to approve access.
When it succeeds, Chronigami shows The Backlog space is connected. The space URL appears under Connected spaces on the General tab.
Note
The connection screen may show a note that Backlog sign-in on localhost only works against the deployed development API. On production Chronigami hosts, use your normal Backlog space.
What Chronigami reads and writes
After the space is connected, Chronigami can call Backlog on behalf of signed-in users (and the portal ticket bot for Portal). Summary:
Reads (examples)
- Issue summary, status, categories, estimates, and allowed custom field types
- Project list and keys
- Custom field definitions (for captured fields and form mapping)
Writes
| Product | What goes to Backlog |
|---|---|
| Time tracking | Optional update to issue Actual Hours (baseline in Backlog plus Chronigami time on that issue), when Update Actual Hours in Backlog is on under Workspace settings → Time tracking |
| Portal | Creates issues from form submissions (summary, description, mapped custom fields, attachments via the ticket bot) |
Chronigami does not delete Backlog issues or spaces when you disconnect or cancel.
Connect more than one space
If your plan allows multiple connections, repeat Connect a Backlog space for each host. Each connection is listed under Connected spaces. To disconnect a space, see Managing connected Backlog spaces.
Next steps
- Invite your team so they can sign in with email or Backlog.
- For Portal editors: Preparing Backlog and Setting up the ticket bot.
- For Time tracking: install the browser extension when developers are ready to use the timer.
Still need help?
Contact supportRelated articles
- Creating your workspaceCreate a Chronigami workspace and set its name, address, and timezone.
- Inviting your teamInvite teammates to your workspace and assign their roles.
- Managing connected Backlog spacesAdd another Backlog space, disconnect with support, and what happens to data and sync.
- Preparing Backlog: projects, issue types, and custom fieldsSet up Backlog projects, issue types, and custom fields before building forms.