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

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

`repass.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` e `rotateSecret` retornam o `secret` em texto **uma única vez**; guarde-o no momento, pois ele não volta a aparecer.

```ts theme={null}
const endpoint = await repass.webhooks.create({
  url: "https://x.com/hook",
  subscribedEvents: ["conversion.created"],
}); // → WebhookEndpointWithSecret (WebhookEndpoint + secret)
endpoint.secret; // mostre/guarde agora; não volta a aparecer

await repass.webhooks.list(); // → RepassPage<WebhookEndpoint>

await repass.webhooks.retrieve("whep_…"); // → WebhookEndpoint

await repass.webhooks.update("whep_…", { status: "disabled" }); // → WebhookEndpoint (atualização parcial)

await repass.webhooks.del("whep_…"); // → void (204)

// Rotacionar o segredo; retorna o novo secret (também uma única vez)
await repass.webhooks.rotateSecret("whep_…"); // → WebhookEndpointWithSecret
```

## Entregas

`deliveries` e `deadLetter` retornam um `RepassPage`. `replayDelivery` recebe o id da **entrega** (`whdl_`), não o do endpoint.

```ts theme={null}
await repass.webhooks.deliveries("whep_…", { status: "failed" }); // → RepassPage<WebhookDelivery> (filtros opcionais por status)

await repass.webhooks.deadLetter("whep_…"); // → RepassPage<WebhookDelivery> (entregas esgotadas após as retentativas)

await repass.webhooks.test("whep_…");           // → WebhookDelivery (dispara uma entrega de teste)
await repass.webhooks.replayDelivery("whdl_…"); // → WebhookDelivery (reenvia uma entrega específica)
```

<Note>
  Para o schema completo de cada corpo (eventos assináveis, status de endpoint e de entrega), consulte 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>