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

# Configuring Kustomer

> Perform the initial setup of Kustomer and FlowEQ

Kustomer is a customer service CRM platform that centralizes conversations and customer data in one place. Once the Kustomer/FlowEQ integration is set up, you can add notes and send emails directly from your Flows in Sidekick without switching platforms.

## Required API permissions

The FlowEQ integration requires a Kustomer API key with the following permissions:

| Permission                         | Purpose                        |
| ---------------------------------- | ------------------------------ |
| `org.permission.conversation.read` | Read conversation data         |
| `org.permission.customer.read`     | Look up customers by ID        |
| `org.permission.klass.read`        | Read Klass definitions         |
| `org.permission.metadata.read`     | Read custom attribute metadata |
| `org.permission.message.create`    | Send messages                  |

## How to connect Kustomer to FlowEQ

<Note>
  For the most up-to-date instructions for generating a Kustomer API key, refer to the [Kustomer API documentation](https://developer.kustomer.com/kustomer-api-docs/reference/authentication).
</Note>

1. In Kustomer, go to **Settings** **Security** **API Keys** and create a new API key
2. Assign the key a role that includes all the permissions listed above. Kustomer's built-in **Org User** role covers most of these — confirm all five permissions are included before saving
3. Copy the API key — it will only be shown once
4. [Click here to open the Kustomer integration](https://app.floweq.com/integrations/kustomer) in FlowEQ, or go to FlowEQ Integrations Lab Kustomer
5. Paste the API key and click **Save**

Once the status shows **Connected**, you can use Kustomer step types in your Flows.

If you run into issues, contact us via your dedicated FlowEQ Slack channel or email [support@floweq.com](mailto:support@floweq.com).
