---
title: "OauthEntity: CDEK API OAuth tokens in Joomla | WT CDEK - WebTolk websites development, Joomla Extensions"
description: "OauthEntity for Joomla: manual CDEK OAuth token retrieval. 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-oauth"
date: "2026-11-02T12:19:42+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) > OauthEntity: CDEK API OAuth tokens in Joomla

# OauthEntity: CDEK API OAuth tokens in Joomla

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)

OauthEntity in WT CDEK for Joomla covers manual CDEK OAuth token retrieval. This reference explains its purpose, parameters and PHP examples for Joomla extensions.

OauthEntity retrieves OAuth tokens manually. Normal integrations authenticate automatically through CdekRequest; direct access is mainly for debugging and custom workflows.

Access the entity through the Cdek facade:

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

## `getOAuthToken()`

### Signature

```
public function getOAuthToken(array $request_options = []): array
```

### REST API

- `POST /v2/oauth/token`

### Purpose

Requests an OAuth token directly.

### Parameters

All three fields are required: `grant_type`, `client_id`, `client_secret`. Use grant_type `client_credentials`.

### Returns

An array with access_token, token_type, expires_in, or an error.

### Example

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$tokenData = $cdek->oauth()->getOAuthToken([
    'grant_type'    => 'client_credentials',
    'client_id'     => 'your_client_id',
    'client_secret' => 'your_client_secret',
]);
```

[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/OauthEntity.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": "OauthEntity: CDEK API OAuth tokens in Joomla"
            }
        }
    ]
}
```

```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-oauth",
            "name": "OauthEntity: CDEK API OAuth tokens in Joomla | WT CDEK - WebTolk websites development, Joomla Extensions",
            "description": "OauthEntity for Joomla: manual CDEK OAuth token retrieval. 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": "OauthEntity: CDEK API OAuth tokens in Joomla",
            "url": "https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-oauth",
            "description": "OauthEntity in WT CDEK for Joomla covers manual CDEK OAuth token retrieval. 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-oauth"
            },
            "keywords": [
                "Joomla",
                " PHP",
                " CDEK API",
                " WT CDEK",
                " OauthEntity",
                " manual CDEK OAuth token retrieval"
            ]
        }
    ]
}
```