Skip to main content
PATCH
https://sandbox.api.hopae.com/connect/v1
/
apps
/
{client_id}
/
webhook_config
curl -X PATCH \
  -H "Authorization: Bearer sk_workspace_test_..." \
  -H "Content-Type: application/json" \
  -d '{"events":["verification.completed","verification.failed"],"retry_attempts":3,"timeout_seconds":10}' \
  "https://sandbox.api.hopae.com/connect/v1/apps/abc123/webhook_config"

{
  "url": "https://hooks.example.com/hopae",
  "enabled": true,
  "events": [
    "verification.initiated",
    "verification.completed",
    "verification.expired",
    "verification.cancelled",
    "verification.failed",
    "verification.awaiting_user_action"
  ],
  "retry_attempts": 3,
  "timeout_seconds": 10
}
Partially updates webhook delivery settings for an app.

​
Request

​
Authorization
string
required
Bearer <API_KEY> from Console > Developers > Workspace API Keys.
​
Content-Type
string
application/json

​
Path parameters

​
client_id
string
required
Client identifier of the app.

​
Request body

​
url
string
Destination URL for webhook delivery.
​
enabled
boolean
Toggle webhook delivery.
​
events
string[]
Subscribed webhook events. Allowed values: verification.initiated, verification.completed, verification.expired, verification.cancelled, verification.failed, verification.awaiting_user_action.
​
retry_attempts
number
Maximum retry attempts per event.
​
timeout_seconds
number
Timeout in seconds per delivery attempt.

​
Response

Returns the updated webhook configuration. 
curl -X PATCH \
  -H "Authorization: Bearer sk_workspace_test_..." \
  -H "Content-Type: application/json" \
  -d '{"events":["verification.completed","verification.failed"],"retry_attempts":3,"timeout_seconds":10}' \
  "https://sandbox.api.hopae.com/connect/v1/apps/abc123/webhook_config"

{
  "url": "https://hooks.example.com/hopae",
  "enabled": true,
  "events": [
    "verification.initiated",
    "verification.completed",
    "verification.expired",
    "verification.cancelled",
    "verification.failed",
    "verification.awaiting_user_action"
  ],
  "retry_attempts": 3,
  "timeout_seconds": 10
}
Webhooks are signed via HMAC-SHA256 using the app’s webhook secret.