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

# Webhooks (CLI)

> Endpoints de webhook, segredo de assinatura, entregas, dead-letter e reenvio.

O grupo `webhooks` gerencia os endpoints de [webhook](/docs/webhooks/visao-geral) e suas entregas: criação, rotação do segredo de [assinatura](/docs/webhooks/assinatura), inspeção das entregas e reenvio.

## Endpoint

`create` recebe o corpo via `--data`/`--file`; o `secret` sai em texto **uma única vez**, nesta resposta.

```bash theme={null}
# Criar (o secret só aparece aqui)
repass webhooks create --data '{"url":"https://exemplo.com/hooks/repass","subscribedEvents":["conversion.created"]}'

# Listar
repass webhooks list --json

# Buscar
repass webhooks get whep_xxx --json

# Atualizar (parcial: url, descrição, eventos ou status)
repass webhooks update whep_xxx --data '{"status":"disabled"}'
```

```json repass webhooks create --json theme={null}
{
  "id": "whep_xxx",
  "url": "https://exemplo.com/hooks/repass",
  "subscribedEvents": ["conversion.created"],
  "status": "active",
  "secret": "whsec_…",
  …
}
```

`webhooks list` é paginado. Veja [Paginação](/docs/cli/paginacao) para `--all` e cursores.

<Warning>
  `webhooks create` mostra o `secret` em claro **uma única vez**, nesta resposta. Guarde-o na hora, ele não pode ser recuperado depois. Se perder, a alternativa é `webhooks rotate-secret` para gerar um novo (o antigo para de validar).
</Warning>

## Exclusão e rotação de segredo

```bash theme={null}
repass webhooks delete whep_xxx --yes           # exclui o endpoint permanentemente
repass webhooks rotate-secret whep_xxx          # gera um novo secret (também em claro só aqui)
```

<Warning>
  `webhooks delete` é `destructive`. Exclui o endpoint permanentemente, sem recuperação. Rode `webhooks get whep_xxx` e `webhooks deliveries whep_xxx` antes para conferir o histórico. Em terminal interativo pede confirmação; fora de TTY exige `--yes` (veja [Convenções](/docs/cli/convencoes#modelo-de-risco)).
</Warning>

<Warning>
  `webhooks rotate-secret` é `sensitive`. O novo segredo de assinatura só aparece em claro nesta resposta e **não há dry-run**. Ao rodar, capture o segredo na hora e atualize o consumidor do webhook em seguida (o segredo antigo deixa de validar).
</Warning>

## Entregas, dead-letter e reenvio

```bash theme={null}
# Histórico de entregas (paginado, filtro por status)
repass webhooks deliveries whep_xxx --status failed --json

# Entregas em dead-letter (tentativas esgotadas)
repass webhooks dead-letter whep_xxx --json

# Dispara uma entrega de teste
repass webhooks test whep_xxx

# Reenvia manualmente uma entrega específica (id da ENTREGA, não do endpoint)
repass webhooks replay-delivery whdl_xxx
```

`webhooks deliveries` e `webhooks dead-letter` são paginados. Veja [Paginação](/docs/cli/paginacao).

<Warning>
  `webhooks replay-delivery` é `sensitive`. Reenvia manualmente aquela entrega para o endpoint. Use `webhooks deliveries whep_xxx` ou `webhooks dead-letter whep_xxx` para escolher a entrega certa antes.
</Warning>

<Note>
  Para o schema completo de cada corpo (eventos assináveis, status de endpoint e de entrega), consulte a página SDK equivalente ([Webhooks](/docs/sdk/recursos/webhooks)) e a [Referência da API](/docs/convencoes/ids-e-recursos). Os conceitos estão em [Webhooks › Visão geral](/docs/webhooks/visao-geral) e [Assinatura](/docs/webhooks/assinatura).
</Note>