Skip to main content
You need a Bronto account with a role that allows creating API keys (for example the API Key Management permissions). API keys are scoped to the roles you assign when creating them.

​
Create a Bronto API key

Bronto authenticates API requests with an API key sent in the X-BRONTO-API-KEY header. Generate one from the Bronto app and paste it, along with your data region, into StackOne Hub.

1

Sign in to Bronto

Sign in to Bronto for the data region your organisation is hosted in, then note which region you used — you will select the matching region in StackOne Hub.

  • EU — Bronto EU dashboard
  • US — Bronto US dashboard
  • On the Login screen, enter your Email and Password and click Login (or use Sign in with Google / Using Single Sign-On?).
  • Use the Data region toggle (EU / US) at the bottom of the login form to pick the region before signing in.
Bronto login screen showing the email and password form and the EU/US Data region toggle
2

Open API Keys settings

Open the API key management screen.

  • In the left sidebar, open Settings.
  • Under Organisation, click API Keys.
Bronto Settings dialog with API Keys highlighted under the Organisation section
3

Add an API key

On the API Keys page, click + Add API key in the top-right corner.

Bronto API Keys list with the Add API key button highlighted
4

Configure and create the key

Fill in the new key details, then create it.

  • Name — enter a descriptive name for the key (for example StackOne Integration).
  • Roles — select a role that grants the access your integration needs. Choose API Full Access Role for full read, write, and delete access; API Search Role for read/search only; or Ingestion Role for sending data. Selecting a role automatically enables its Permissions.
  • Expiration — leave as Never, or choose an expiry if you want the key to expire.
  • Click Create key.
Bronto Add API key form showing the Name field, Roles selector, Expiration, and Create key button
5

Copy the API key

After creating the key, the Your new API key banner shows the key value.

  • Click Copy to copy the key (use the eye icon to reveal it first if you want to check it).
  • This key is only shown once — Save this key somewhere secure. It won’t be shown again after you leave this page. If you lose it, delete the key and create a new one.
Bronto Your new API key banner with the masked key value and the Copy button highlighted

​
Connect in StackOne Hub

Enter the values you collected into StackOne Hub to finish connecting Bronto.

1

Enter your credentials

In StackOne Hub, complete the Bronto connection fields:

  • Data Region — select the region you signed in to (EU (api.eu.bronto.io) or US (api.us.bronto.io)). This must match your Bronto account’s region.
  • API Key — paste the API key you copied from Bronto. It is sent as the X-BRONTO-API-KEY header on every request.

​
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:
  • Data Region
  • 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.

​
Next Steps

Webhooks setup

Configure receiving Events for Bronto into StackOne.