> ## Documentation Index
> Fetch the complete documentation index at: https://university.triggr-app.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sherweb

> Connect Sherweb to Triggr with a Sherweb API application (client ID, client secret and subscription key).

Triggr works with your Sherweb customers, catalogue, orders, subscriptions and platforms. One configuration covers all your customers.

## Set up Sherweb

<Steps>
  <Step title="Create an API application">
    In the [Sherweb partner portal](https://cumulus.sherweb.com), go to **Security > APIs** and create an application named `Triggr`. The Account Administrator role has access.
  </Step>

  <Step title="Copy the keys">
    Copy the Client ID, Client Secret and Subscription Key. Sherweb shows the client secret only in this dialog.
  </Step>
</Steps>

See Sherweb's [API prerequisites](https://github.com/sherweb/Public-Apis#prerequisite-for-using-the-apis) and [Developer Platform](https://developers.sherweb.com/docs/get-started).

## Connect it in Triggr

<Steps>
  <Step title="Open the configuration">
    Go to **Integrations > Sherweb** and click **Configure** on the Base Configuration card.

    <Frame>
      <img src="https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/integrations-common/base-configuration.png?fit=max&auto=format&n=nyuVXZ1rouDTTEvu&q=85&s=bb81acb082055015f91beda7b4876f35" alt="The Base Configuration card with Status Not Configured, Admin Consent Not Required and a Configure button." width="2272" height="330" data-path="images/integrations-common/base-configuration.png" />
    </Frame>
  </Step>

  <Step title="Enter the keys">
    Enter the ClientID, ClientSecret and SubscriptionKey (the key from Security > APIs, not a product subscription ID), then click Save Configuration.

    <Frame>
      <img src="https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/sherweb/configure.png?fit=max&auto=format&n=nyuVXZ1rouDTTEvu&q=85&s=3bcf3f02417246ef4127a893b502e8b0" alt="The Sherweb configuration window with ClientID, ClientSecret and SubscriptionKey fields, an Allow insecure TLS switch under Advanced, and a Save Configuration button." width="1344" height="1354" data-path="images/sherweb/configure.png" />
    </Frame>
  </Step>
</Steps>

Actions for one customer take its Sherweb customer ID, which Get Customers returns.

## Use it in Triggr Core

Core can buy a licence seat at Sherweb when a new starter has none free. Set **Default distributor** to Sherweb in Core's Settings > General, then link each client to its Sherweb customer (saved as the client's `sherwebId` variable) and map its licences. See [Licences and distributors](/core/manage/licences-and-distributors#buy-seats-automatically).

## Troubleshooting

<AccordionGroup>
  <Accordion title="401 errors">
    Check all three values were pasted in full and come from the same application, and that it still exists under Security > APIs.
  </Accordion>

  <Accordion title="SubscriptionKey is missing from sherweb configuration">
    Core found no complete Sherweb connection. Save the Base Configuration with all three fields, then run the onboarding again.
  </Accordion>

  <Accordion title="Client not linked to Sherweb — won't auto-buy">
    In Core, open the client, click Map next to Sherweb under Integrations, pick its Sherweb customer and click Save mapping.
  </Accordion>

  <Accordion title="Calls are refused although the keys are correct">
    Ask Sherweb to confirm Service Provider API access is enabled for your partner account.
  </Accordion>

  <Accordion title="Lost the client secret">
    Create a new API application, then click Edit on the Base Configuration card and enter all three of its values.
  </Accordion>

  <Accordion title="Rate limits">
    Sherweb allows 3 concurrent requests, 100 a minute and 10,000 a day. Run large workflows in smaller batches. See Sherweb's [Limits](https://developers.sherweb.com/docs/limits).
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.