Skip to main content
API access is not enabled by default. Contact your Rillet team to turn it on for your organization before you try to create a key, otherwise the API Access page will be empty.

​
Create a Rillet API key

Rillet authenticates every request with a bearer API key issued per organization. Create one in Organization Settings, then paste it into StackOne Hub along with the environment you want to connect.

1

Ask Rillet to enable API access

API access is gated per organization. Contact your Rillet team and ask them to enable API access for your account. Until they do, the API Access settings page will not let you create keys.

2

Open Organization Settings > API Access

Sign in to Rillet as a user whose role permits managing API keys, then go to Organization Settings > API Access.

3

Create the key and copy it

Create a new API key and copy the value straight away — it is shown only once.

  • Keys do not expire. Revoking a key in Rillet takes effect immediately and will break any StackOne connection still using it.
  • The key acts with the Rillet role permissions of the user who created it. If some actions return 403 Forbidden while others succeed, the key is valid but that user’s role does not permit the operation.
4

Choose the matching environment

When you create the connection in StackOne, select Production to reach your live Rillet organization or Sandbox to reach the Rillet test environment. Rillet runs the two as separate systems with separate keys, so the environment you pick must match where the key was created — a production key will not authenticate against the sandbox, and vice versa.

5

Paste the key into StackOne

Paste the key into the API Key field in StackOne Hub and save the connection. StackOne verifies it by calling the Rillet API key information endpoint, which confirms both that the key is recognised and which organization it belongs to.

​
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 Key
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.