PHPackages justpush/justpush-php-sdk - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. justpush/justpush-php-sdk ActiveLibrary[Mail & Notifications](/categories/mail) justpush/justpush-php-sdk ========================= SDK To send push messages through PHP 1.0.17(1y ago)03.0kproprietaryPHPPHP ^8.0 Since Jun 7Pushed 1y agoCompare [ Source](https://github.com/JustPush-io/justpush-sdk-php)[ Packagist](https://packagist.org/packages/justpush/justpush-php-sdk)[ RSS](/packages/justpush-justpush-php-sdk/feed)WikiDiscussions main Synced 2d ago READMEChangelogDependencies (3)Versions (17)Used By (0) [![](https://camo.githubusercontent.com/e4b90684ed9096dea2f649c107100cdc30a673ae162c462f8b789e67ecbbeea2/68747470733a2f2f63646e2e6a757374707573682e696f2f636f72652f61707025323069636f6e5f6e6f6261636b67726f756e642e737667)](https://camo.githubusercontent.com/e4b90684ed9096dea2f649c107100cdc30a673ae162c462f8b789e67ecbbeea2/68747470733a2f2f63646e2e6a757374707573682e696f2f636f72652f61707025323069636f6e5f6e6f6261636b67726f756e642e737667) JustPush - PHP SDK ------------------ [](#justpush---php-sdk) Welcome to the official PHP SDK for JustPush! This SDK allows you to easily integrate with our powerful messaging platform, providing functionalities to create messages, retrieve messages, create topics, and update topics. Features -------- [](#features) - **Create Messages**: Send messages effortlessly using our streamlined API. - **Retrieve Messages**: Fetch messages with ease for seamless integration and processing. - **Create Topics**: Organize your messages by creating specific topics. - **Update Topics**: Modify existing topics to keep your message structure flexible and up-to-date. Download the App in the App Stores ---------------------------------- [](#download-the-app-in-the-app-stores) Installation ------------ [](#installation) Install the SDK via Composer: ``` composer require justpush/justpush-php-sdk ``` Basic Push Message ------------------ [](#basic-push-message) This is a basic example of sending a notification. ``` $response = JustPushMessage::token('REPLACE_WITH_USER_TOKEN') ->message('Here is a sample Message') ->title('Test Title') ->create(); echo json_encode($response->result(), JSON_PRETTY_PRINT); //Result echo json_encode($response->responseHeaders(), JSON_PRETTY_PRINT); //Response Headers ``` JustPush Message ================ [](#justpush-message) Function NameAvailable AttributesDescription`token``string $token`Set the user token / API token`message``string $message`The textual body of the message`title``string $title`The title of the message`topic``string $topic`Either the UUID or the name of the topic you want to send the message to`image``string $url`, `?string $caption`Adds an image the to the message`images``array $images`Adds multiple images`button``string $cta`, `string $url`, `bool $actionRequired`Adds a button to the message`buttons``array $buttons`Adds multiple buttons to the message`sound``string $sound`Define the sound of the message`priority``int $priority`Manually set the priority, `2`, `1`, `0`, `-1`, `-2``highestPriority`Set the message priority on `2``highPriority`Set the message priority on `1``normalPriority`Set the message priority on `0``lowPriority`Set the message priority on `-1``lowestPriority`Set the message priority on `-2``expiry``int $expiry`Set the expiry in Seconds`acknowledge``bool $requiresAcknowledgement`, `bool $requiresRetry = false`, `int $retryInterval = 0`, `int $maxRetries = 0`, `bool $callbackRequired = false`, `?string $callbackUrl = null`, `?array $callbackParams = null`Adds an acknowledgement to the messages### Defining the topic [](#defining-the-topic) Our goals it to keep the API as simple as possible. Therefore, you can send either: - **Topic Title** - When the title exists more than once, the oldest topic will be used. If the name is not in your topic list, a new topic will be created. - **Topic UUID** - Uses the exact match of the topic ### Sending multiple images [](#sending-multiple-images) When a message contains multiple images, the first image will be used for the push message banner. ### Setting an Expiry [](#setting-an-expiry) When an expiry is set, the message will have an TTL in seconds. After the expiry, in seconds, has expired, the message will automatically be hidden. JustPush Topics =============== [](#justpush-topics) Function NameAvailable Attributes`__construct``$token``token``string $token``title``?string $title``topic``?string $topicUuid``avatar``?string $url`, `?string $body`POST / Create A Topic --------------------- [](#post--create-a-topic) This is a basic example of creating a topic ``` $response = JustPushTopic::token('REPLACE_WITH_USER_TOKEN') ->title('New Topic') ->create(); echo json_encode($response->result(), JSON_PRETTY_PRINT); //Result echo json_encode($response->responseHeaders(), JSON_PRETTY_PRINT); //Response Headers ``` PUT / Update A Topic -------------------- [](#put--update-a-topic) This is a basic example of updating a topic ``` $response = JustPushTopic::token('REPLACE_WITH_USER_TOKEN') ->topic('REPLACE_WITH_TOPIC_UUID') ->title('New Topic Title') ->update(); echo json_encode($response->result(), JSON_PRETTY_PRINT); //Result echo json_encode($response->responseHeaders(), JSON_PRETTY_PRINT); //Response Headers ``` GET / Get a topic ----------------- [](#get--get-a-topic) This is a basic example of creating a topic ``` $response = JustPushTopic::token('REPLACE_WITH_USER_TOKEN') ->topic('REPLACE_WITH_TOPIC_UUID') ->get(); echo json_encode($response->result(), JSON_PRETTY_PRINT); //Result echo json_encode($response->responseHeaders(), JSON_PRETTY_PRINT); //Response Headers ``` ### Response Headers [](#response-headers) KeyValueDescription`X-Limit-App-Limit``["10000"]`The amount of messages that you can send based on your active subscription`X-Limit-App-Remaining``["9895"]`The amount of messages you have left for the current period in your subscription`X-Limit-App-Limit``["234512"]`The seconds till the monthly reset will be done.OpenApi Spec ------------ [](#openapi-spec) The package comes with an OpenAPI spec. Which can be found in the `docs` folder. [Click Here](https://github.com/JustPush-io/justpush-sdk-php/tree/docs) Changelog --------- [](#changelog) - 1.0.17 - Added Button Groups - 1.0.15 - Added retry mechanism for `acknowledgements` ### Health Score 34 — LowBetter than 75% of packages Maintenance42 Moderate activity, may be stable Popularity21 Limited adoption so far Community7 Small or concentrated contributor base Maturity54 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~19 days Recently: every ~69 days Total 16 Last Release 463d ago PHP version history (2 changes)1.0.1PHP ^8.2 1.0.8PHP ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/e6b1fdd8b9a7e293e4ffadab4e42dc3d112d033722e9b37c4fcb2be7e82e70a2?d=identicon)[hniehorster](/maintainers/hniehorster) ![](https://avatars.githubusercontent.com/u/36570406?v=4)[JustPush](/maintainers/JustPush)[@justpush](https://github.com/justpush) --- Top Contributors [![hniehorster](https://avatars.githubusercontent.com/u/12053327?v=4)](https://github.com/hniehorster "hniehorster (21 commits)") ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/justpush-justpush-php-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/justpush-justpush-php-sdk/health.svg)](https://phpackages.com/packages/justpush-justpush-php-sdk) ``` ### Alternatives [aws/aws-sdk-php AWS SDK for PHP - Use Amazon Web Services in your PHP project 6.3k543.5M2.6k](/packages/aws-aws-sdk-php)[neuron-core/neuron-ai The PHP Agentic Framework. 2.0k656.1k38](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php TencentCloudApi php sdk 3741.3M46](/packages/tencentcloud-tencentcloud-sdk-php)[tempest/framework The PHP framework that gets out of your way. 2.2k34.4k15](/packages/tempest-framework)[guanguans/notify Push notification SDK(AnPush、Bark、Chanify、DingTalk、Discord、Gitter、GoogleChat、IGot、Lark、Mattermost、MicrosoftTeams、NotifyX、NowPush、Ntfy、Push、Pushback、PushBullet、PushDeer、PushMe、Pushover、PushPlus、QQ、RocketChat、ServerChan、ShowdocPush、SimplePush、Slack、Telegram、WeWork、WPush、XiZhi、YiFengChuanHua、ZohoCliq、ZohoCliqWebHook、Zulip). 687114.3k8](/packages/guanguans-notify)[erag/laravel-disposable-email A Laravel package to detect and block disposable email addresses. 254168.5k](/packages/erag-laravel-disposable-email) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)