Skip to main content

​
Sign in to the Wrangle web app

Wrangle uses Slack (or Microsoft Teams) as its identity provider, so there is no separate Wrangle password.

1

Open the Wrangle login page

Go to the Wrangle login page.

  • Click Log In With Slack.
The Wrangle login page with the Log In With Slack and Log In With Teams buttons
2

Approve the Wrangle app in Slack

Slack shows the Allow the “Wrangle” app to access Slack consent screen listing the permissions Wrangle requests.

  • Under Workspace, choose the workspace you want to connect.
  • Review the entries under Information “Wrangle” can view and Actions “Wrangle” can take.
  • Click Allow to finish signing in.
The Slack consent screen for the Wrangle app with the Workspace picker and Allow button highlighted

​
Copy the three API credentials

All three values this connection needs are shown on one page in the Wrangle web app. The Wrangle API is part of the Scale plan and is also available during the free trial.

1

Open the Wrangle API integration page

In the Wrangle sidebar, expand Integrations and click Wrangle API. The page opens on Wrangle API with an Authentication section.

  • If the banner reads The Wrangle API is part of the Scale plan, you can use the API for the duration of your trial; to keep it afterwards, upgrade from the linked billing page.
The Wrangle API page showing the Wrangle API sidebar link, the API Token value and the slackWorkspaceId and slackUserId parameters
2

Copy the API token

Under Authentication, find the line beginning API Token.

  • Click show to reveal the token value, then copy it.
  • Paste it into the API Token field in StackOne Hub.
  • Wrangle warns to keep it private — Make sure you do not share your API token with anyone outside your company. Treat it like a password.
3

Copy the Slack workspace and user IDs

Below the token, Wrangle lists the two values it expects as GET parameters on every API call.

  • Copy the value shown after slackWorkspaceId and paste it into the Slack Workspace ID field in StackOne Hub.
  • Copy the value shown after slackUserId and paste it into the Slack User ID field in StackOne Hub. This identifies the Slack user the Wrangle API acts on behalf of.
  • Format: slackWorkspaceId starts with T, slackUserId starts with U.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • API Token
  • Slack User ID
  • Slack Workspace ID
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.