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

# Criar Cliente

> Crie um novo cliente OAuth para incorporação via iframe.

Clientes OAuth são **credenciais para incorporação via iframe**. Eles fornecem um par `clientId` e `clientSecret` que seu backend usa para autenticar e incorporar o editor de fluxos do whatabot dentro do seu próprio aplicativo via iframe.

Cada cliente é vinculado a um único [espaço de trabalho](/api-reference/workspaces/create-workspace), portanto o editor incorporado só pode acessar fluxos e setores dentro daquele espaço de trabalho.

Consulte o guia completo de [Incorporação](/embed/overview) e [Autenticação de Incorporação](/embed/authentication) para mais detalhes.

<ParamField header="X-Api-Key" type="string" required>
  Sua chave de API (prefixada com `wh_`).
</ParamField>

### Body

<ParamField body="name" type="string" required>
  Nome de exibição do cliente.
</ParamField>

### Exemplos de payload

<Tabs>
  <Tab title="Criar cliente">
    ```json theme={null}
    {
      "name": "My SaaS Embed"
    }
    ```
  </Tab>
</Tabs>

<RequestExample>
  ```bash theme={null}
  curl -X POST https://api.whatabot.app/api/v1/clients \
    -H "X-Api-Key: wh_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{"name": "My SaaS Embed"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "clientId": "wb_client_abc123",
    "clientSecret": "wb_secret_xyz789",
    "name": "My SaaS Embed"
  }
  ```
</ResponseExample>

<Warning>
  O `clientSecret` é retornado apenas uma vez no momento da criação. Armazene-o
  com segurança.
</Warning>