Pular para o conteúdo principal
PUT
https://api.owem.com.br
/
v4
/
i
/
webhooks
/
config
/
{configId}
Atualizar Webhook
curl --request PUT \
  --url https://api.owem.com.br/v4/i/webhooks/config/{configId} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "event": [
    {}
  ],
  "targetUrl": "<string>"
}
'
{
  "requestId": "a111b222-c333-4d44-8e55-f66677788899",
  "success": true,
  "size": 1,
  "data": {
    "configId": "wc_bd121426-4da1-4de4-b420-1b063aef81ee",
    "userId": "usr_abcdef12",
    "event": ["pix_in:qrcode_paid"],
    "targetUrl": "https://hooks.cliente.com/owem",
    "authHeader": "Bearer whsec_abc123example",
    "isEnabled": true,
    "createdAt": 1766523042000,
    "updatedAt": 1766526642000,
    "deletedAt": null,
    "id": "wc_bd121426-4da1-4de4-b420-1b063aef81ee",
    "uid": "wc_bd121426-4da1-4de4-b420-1b063aef81ee"
  }
}

​
Finalidade

Atualiza os campos informados de uma configuração de webhook existente.

​
Autenticação

​
Authorization
string
obrigatório
Basic Auth obrigatório no formato: Basic {Base64(API_KEY:API_SECRET)}

​
Path Parameters

​
configId
string
obrigatório
ID da configuração de webhook

​
Request Body

​
event
array
Conjunto de eventos. Use ["*"] para todos ou liste eventos específicos.
​
targetUrl
string
Endpoint público que receberá os webhooks (POST deve responder 2xx em ≤ 3s).
Somente event e targetUrl são aceitos. Campos não enviados não são alterados.

​
Resposta

​
requestId
string
UUID para rastreio
​
success
boolean
Status da operação
​
size
number
Quantidade de itens retornados
​
data
object
{
  "requestId": "a111b222-c333-4d44-8e55-f66677788899",
  "success": true,
  "size": 1,
  "data": {
    "configId": "wc_bd121426-4da1-4de4-b420-1b063aef81ee",
    "userId": "usr_abcdef12",
    "event": ["pix_in:qrcode_paid"],
    "targetUrl": "https://hooks.cliente.com/owem",
    "authHeader": "Bearer whsec_abc123example",
    "isEnabled": true,
    "createdAt": 1766523042000,
    "updatedAt": 1766526642000,
    "deletedAt": null,
    "id": "wc_bd121426-4da1-4de4-b420-1b063aef81ee",
    "uid": "wc_bd121426-4da1-4de4-b420-1b063aef81ee"
  }
}

​
Códigos de Status

HTTPDescrição
200Configuração atualizada
400Payload inválido
401Credenciais inválidas
403IP não allowlisted
404configId não encontrado
409Conflito de configuração
429Rate limit excedido
500Erro interno

​
Exemplo de Request

{
  "event": ["pix_in:qrcode_paid"],
  "targetUrl": "https://novo-endpoint.cliente.com/owem"
}