Capabilities
The connector reads workspace members and groups from Shortcut. Each group
exposes a
member entitlement; the connector syncs which members belong to
each group. Each member’s workspace role (such as Owner, Admin, or Member) is
recorded as a profile attribute. Shortcut agent members sync as service
accounts; all other members sync as users.
This connector is read-only. It does not provision or modify access in
Shortcut.
Gather Shortcut credentials
1
In Shortcut, open your account settings and go to
API Tokens.
2
Generate a new API token. The token scopes the connector to the workspace
it was created in.
3
Under Permissions, select Custom permissions and check Read.
Leave Write (including Create Stories and Create Story
Comments) and Admin unchecked.
4
Copy the token value. You enter it as the API token when configuring
the connector.
Configure the Shortcut connector
- Cloud-hosted
- Self-hosted
Follow these instructions to use a built-in, no-code connector hosted by C1.Done. Your Shortcut connector is now pulling access data into C1.
1
In C1, navigate to Apps > Connectors and click Add connector.
2
Search for Shortcut and click Add.
3
Choose where to add the connector: Create a new app, or Add to an existing app (then select the app).If you’re creating a new app, choose whether to link it to an application discovered from your identity provider: select Yes and pick the IdP application, or No to continue with just the connector.
4
Set the connector’s Name and, optionally, a Description.
5
Click the pencil icon next to Owners to choose who can configure and manage this connector.
6
Click Add. The connector is created and its configuration page opens.
7
On the configuration page, find the Resource capabilities area. Enable Users and Groups.C1 disables both resource types by default. Until you enable them, no Shortcut data syncs.
8
Find the Settings area of the page and click Edit.
9
Enter the Shortcut credentials:
- API token: The API token you copied above.
https://api.app.shortcut.com. This is the Shortcut API host, not the app.shortcut.com address you sign in at.10
Click Save.
11
The connector’s label changes to Syncing, followed by Connected. You can view the logs to ensure that information is syncing.