> ## 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.

# Simplesat

> Connect Simplesat to Triggr with a Simplesat API key, so workflows can read survey feedback and keep customers and team members up to date.

Triggr works with Simplesat survey responses and answers, customers and team members.

## Set up Simplesat

<Steps>
  <Step title="Create a key">
    As an Owner or Admin, go to **Settings > API keys** ([open it](https://app.simplesat.io/settings/api-keys/)), click **Create API key** and name it `Triggr`.
  </Step>

  <Step title="Choose its access">
    Full access covers every scope. For Custom, select the scopes your workflows need:

    | Scope | Triggr actions |
    | - | - |
    | `read responses` | Search Responses, Get Response |
    | `write responses` | Create or Update Response |
    | `read answers` | Search Answers, Get Answer |
    | `write answers` | Update Answer |
    | `read customers` | List Customers, Get Customer |
    | `write customers` | Create or Update Customer, Update Customer, Bulk Create or Update Customers |
    | `read team members` | Get Team Member |
    | `write team members` | Create or Update Team Member |
  </Step>

  <Step title="Copy the secret">
    Create the key and copy the secret. Simplesat shows it only once.
  </Step>
</Steps>

See Simplesat's [API keys management](https://help.simplesat.io/en/articles/4020334-api-keys-management).

## Connect it in Triggr

<Steps>
  <Step title="Open the configuration">
    Go to **Integrations > Simplesat** 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 secret">
    Paste the secret into API Key and click Save Configuration.

    <Frame>
      <img src="https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/simplesat/configure.png?fit=max&auto=format&n=nyuVXZ1rouDTTEvu&q=85&s=31effe2d4f6a3cee8a0746262f5fae93" alt="The Simplesat configuration window with an API Key field and help text listing the scopes a Custom key needs, an Allow insecure TLS switch under Advanced, and a Save Configuration button." width="1344" height="1026" data-path="images/simplesat/configure.png" />
    </Frame>
  </Step>
</Steps>

In workflows, Create or Update Customer and Create or Update Team Member match on `email`, and sending `tags` or `custom_attributes` replaces the existing values.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Every action fails with 403 Invalid Token.">
    Check the secret was pasted in full and the key still exists in Settings > API keys. Otherwise create a new key.
  </Accordion>

  <Accordion title="Some actions work and others are refused">
    The Custom key is missing a scope. Add it in Settings > API keys; the secret stays the same.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Simplesat limits requests per account each minute. Space out large runs and retry after the `Retry-After` seconds.
  </Accordion>
</AccordionGroup>


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