Skip to main content
PUT
https://api.owem.com.br
/
v4
/
i
/
webhooks
/
config
/
{configId}
Update 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.yourserver.com/owem",
    "authHeader": "Bearer whsec_abc123example",
    "isEnabled": true,
    "createdAt": 1760000000000,
    "updatedAt": 1760003600000,
    "deletedAt": null,
    "id": "wc_bd121426-4da1-4de4-b420-1b063aef81ee",
    "uid": "wc_bd121426-4da1-4de4-b420-1b063aef81ee"
  }
}

Purpose

Updates the specified fields of an existing webhook configuration. Fields not sent are not changed.

Authentication

Authorization
string
required
Basic Auth required in format: Basic {Base64(API_KEY:API_SECRET)}

Path Parameters

configId
string
required
Unique identifier of the webhook configuration

Request Body

event
array
Set of events. Use ["*"] for all or list specific events.
targetUrl
string
Public HTTPS endpoint to receive webhooks (POST must respond 2xx within 3s).
Only event and targetUrl are accepted in this route.

Response

requestId
string
UUID for tracking
success
boolean
Operation status
size
number
Number of returned items
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.yourserver.com/owem",
    "authHeader": "Bearer whsec_abc123example",
    "isEnabled": true,
    "createdAt": 1760000000000,
    "updatedAt": 1760003600000,
    "deletedAt": null,
    "id": "wc_bd121426-4da1-4de4-b420-1b063aef81ee",
    "uid": "wc_bd121426-4da1-4de4-b420-1b063aef81ee"
  }
}

Status Codes

HTTPWhen it occurs
200Configuration updated successfully
400Invalid payload (malformed URL, invalid events)
401Invalid/revoked credentials
403IP not allowlisted
404configId not found
409Configuration conflict (when applicable)
429Rate limit exceeded
500Internal error