---
title: "WebhooksEntity: CDEK webhooks for Joomla and PHP | WT CDEK - WebTolk websites development, Joomla Extensions"
description: "WebhooksEntity for Joomla: webhook subscriptions and Joomla callback URLs. WT CDEK documentation with CDEK API parameters and PHP integration examples."
url: "https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-webhooks"
date: "2026-11-02T12:18:10+00:00"
language: "en-GB"
---

## Breadcrumbs

[Home](https://web-tolk.ru/en) > [Joomla extensions](https://web-tolk.ru/en/dev) > [Libraries](/en/dev/biblioteki) > [WT CDEK library](/en/dev/biblioteki/wt-cdek-library-for-joomla-developers) > [Documentation](/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation) > WebhooksEntity: CDEK webhooks for Joomla and PHP

# WebhooksEntity: CDEK webhooks for Joomla and PHP

WT CDEK library - Documentation

**Category:** [Libraries](https://web-tolk.ru/en/dev/biblioteki)

[Project](https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers)[Versions](https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/versions)[Documentation](https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation)[GitHub](https://github.com/WebTolk/WT-CDEK-Joomla-PHP-library)

WebhooksEntity in WT CDEK for Joomla covers webhook subscriptions and Joomla callback URLs. This reference explains its purpose, parameters and PHP examples for Joomla extensions.

WebhooksEntity manages CDEK webhook subscriptions and builds a Joomla incoming-webhook URL for the wtcdek system plugin.

Access the entity through the Cdek facade:

```
$webhooks = $cdek->webhooks();
```

## `getAllowedTypes()`

### Signature

```
public function getAllowedTypes(): array
```

### REST API

No REST API call.

### Purpose

Returns the webhook types known to the library without calling the API: ORDER_STATUS, ORDER_MODIFIED, PRINT_FORM, RECEIPT, PREALERT_CLOSED, ACCOMPANYING_WAYBILL, OFFICE_AVAILABILITY, DELIV_PROBLEM, DELIV_AGREEMENT, COURIER_INFO.

### Parameters

No parameters.

### Returns

Array of type strings.

### Example

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();
$types = $cdek->webhooks()->getAllowedTypes();
```

## `getAll()`

### Signature

```
public function getAll(): array
```

### REST API

- `GET /v2/webhooks`

### Purpose

Lists active webhook subscriptions.

### Parameters

No parameters.

### Returns

Subscription records.

### Example

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();
$webhooks = $cdek->webhooks()->getAll();
```

## `create()`

### Signature

```
public function create(string $url, string $type): array
```

### REST API

- `POST /v2/webhooks`

### Purpose

Creates a webhook subscription.

### Parameters

`$url`: valid handler URL; `$type`: an allowed type from getAllowedTypes(). The library validates both.

### Returns

Asynchronous subscription-creation response.

### Example

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->webhooks()->create(
    'https://example.com/index.php?option=com_ajax&plugin=wtcdek&group=system&format=raw&action=webhook',
    'ORDER_STATUS'
);
```

## `deleteByUuid()`

### Signature

```
public function deleteByUuid(string $uuid): array
```

### REST API

- `DELETE /v2/webhooks/{uuid}`

### Purpose

Deletes a webhook subscription.

### Parameters

`$uuid`: subscription UUID.

### Returns

API response array.

### Example

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->webhooks()->deleteByUuid('11111111-1111-1111-1111-111111111111');
```

## `getByUuid()`

### Signature

```
public function getByUuid(string $uuid): array
```

### REST API

- `GET /v2/webhooks/{uuid}`

### Purpose

Retrieves one webhook subscription.

### Parameters

`$uuid`: subscription UUID.

### Returns

Subscription data.

### Example

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->webhooks()->getByUuid('11111111-1111-1111-1111-111111111111');
```

## `getJoomlaWebhookUrl()`

### Signature

```
public function getJoomlaWebhookUrl(): string
```

### REST API

No REST API call.

### Purpose

Builds the com_ajax URL for incoming webhooks without calling the API.

### Parameters

Requires enabled System - WT Cdek plugin and a configured webhook_token.

### Returns

URL string, or an empty string if it cannot be built.

### Example

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();
$url = $cdek->webhooks()->getJoomlaWebhookUrl();
```

[Overview and getting started](https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-library-joomla-form-fields)

[WT CDEK 1.4.0 source code on GitHub](https://github.com/WebTolk/WT-CDEK-Joomla-PHP-library/blob/v.1.4.0/lib_webtolk_wtcdek/src/Entities/WebhooksEntity.php)

## JSON-LD Schema

```json
{
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17",
    "itemListElement": [
        {
            "@type": "ListItem",
            "position": 1,
            "item": {
                "@id": "https://web-tolk.ru/en",
                "name": "Home"
            }
        },
        {
            "@type": "ListItem",
            "position": 2,
            "item": {
                "@id": "https://web-tolk.ru/en/dev",
                "name": "Joomla extensions"
            }
        },
        {
            "@type": "ListItem",
            "position": 3,
            "item": {
                "@id": "/en/dev/biblioteki",
                "name": "Libraries"
            }
        },
        {
            "@type": "ListItem",
            "position": 4,
            "item": {
                "@id": "/en/dev/biblioteki/wt-cdek-library-for-joomla-developers",
                "name": "WT CDEK library "
            }
        },
        {
            "@type": "ListItem",
            "position": 5,
            "item": {
                "@id": "/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation",
                "name": "Documentation"
            }
        },
        {
            "@type": "ListItem",
            "position": 6,
            "item": {
                "name": "WebhooksEntity: CDEK webhooks for Joomla and PHP"
            }
        }
    ]
}
```

```json
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Organization",
            "@id": "https://web-tolk.ru/#/schema/Organization/base",
            "name": "WebTolk",
            "url": "https://web-tolk.ru/",
            "logo": {
                "@type": "ImageObject",
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo",
                "url": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "contentUrl": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "width": 1920,
                "height": 1080
            },
            "image": {
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo"
            },
            "sameAs": [
                "https://github.com/WebTolk",
                "https://github.com/sergeytolkachyov",
                "https://vk.com/web_tolk",
                "https://vk.com/webtolkru",
                "https://tenchat.ru/sergeytolkachyov",
                "https://t.me/sergeytolkachyov",
                "https://t.me/webtolkru"
            ]
        },
        {
            "@type": "WebSite",
            "@id": "https://web-tolk.ru/#/schema/WebSite/base",
            "url": "https://web-tolk.ru/",
            "name": "WebTolk websites development, Joomla Extensions",
            "publisher": {
                "@id": "https://web-tolk.ru/#/schema/Organization/base"
            }
        },
        {
            "@type": "WebPage",
            "@id": "https://web-tolk.ru/#/schema/WebPage/base",
            "url": "https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-webhooks",
            "name": "WebhooksEntity: CDEK webhooks for Joomla and PHP | WT CDEK - WebTolk websites development, Joomla Extensions",
            "description": "WebhooksEntity for Joomla: webhook subscriptions and Joomla callback URLs. WT CDEK documentation with CDEK API parameters and PHP integration examples.",
            "isPartOf": {
                "@id": "https://web-tolk.ru/#/schema/WebSite/base"
            },
            "about": {
                "@id": "https://web-tolk.ru/#/schema/TechArticle/base"
            },
            "inLanguage": "en-GB",
            "breadcrumb": {
                "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17"
            }
        },
        {
            "@type": "TechArticle",
            "headline": "WebhooksEntity: CDEK webhooks for Joomla and PHP",
            "url": "https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-webhooks",
            "description": "WebhooksEntity in WT CDEK for Joomla covers webhook subscriptions and Joomla callback URLs. This reference explains its purpose, parameters and PHP examples for Joomla extensions.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-webhooks"
            },
            "keywords": [
                "Joomla",
                " PHP",
                " CDEK API",
                " WT CDEK",
                " WebhooksEntity",
                " webhook subscriptions and Joomla callback URLs"
            ]
        }
    ]
}
```