Get Webhook Details

GET

https://platform-api.convirza.com/v3/webhooks/{id}

Webhooks

Last modified:2026-07-24 13:10:44

Retrieves the complete configuration and settings for a specific webhook.

Returned information

Identity: Webhook ID, name, and description

Configuration: Target URL, HTTP method, response format

Payload settings: Data inclusion flags (data_append, dni_logs, indicator_scores, ivr_keypresses)

Static parameters: Custom key-value pairs sent with every request

Status: Current state (active, inactive, deleted)

Audit trail: Creation and last update timestamps with user IDs

Validation

Webhook ID must be a positive integer

Webhook must exist and belong to your organization

Non-numeric, zero, or negative IDs return 400 Bad Request

Non-existent IDs return 404 Not Found

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200

application/json

Successfully retrieved webhook details

Bodyapplication/json

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://platform-api.convirza.com/v3/webhooks/{id}' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "code": 200,
    "message": "Success",
    "data": {
        "webhook_id": 123,
        "webhook_name": "Lead Notification Webhook",
        "org_unit_id": 1001,
        "target_url": "https://api.example.com/webhooks/leads",
        "webhook_desc": "Sends lead data to CRM system",
        "webhook_created": "2026-01-01T10:00:00Z",
        "webhook_updated": "2026-02-01T15:30:00Z",
        "response_format": "JSON",
        "http_method": "POST",
        "include_data_append": false,
        "include_dni": true,
        "include_score": true,
        "include_ivr_keypresses": false,
        "webhook_status": "active",
        "static_parameters": [
            {
                "webhook_id": 123,
                "field_name": "api_key",
                "field_id": "",
                "field_value": "your-api-key",
                "map_order": 1
            }
        ]
    },
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-01-20T12:34:56.789Z"
}

Modified at 2026-07-24 13:10:44

Create Webhook

List Webhooks