PHPackages                             hooksniff/hooksniff - 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. [HTTP &amp; Networking](/categories/http)
4. /
5. hooksniff/hooksniff

ActiveLibrary[HTTP &amp; Networking](/categories/http)

hooksniff/hooksniff
===================

Official PHP SDK for the HookSniff webhook delivery API

1.2.1(3w ago)06MITPHPPHP &gt;=8.1

Since May 8Pushed 6d agoCompare

[ Source](https://github.com/servetarslan02/hooksniff-php)[ Packagist](https://packagist.org/packages/hooksniff/hooksniff)[ Docs](https://hooksniff.vercel.app)[ GitHub Sponsors](https://github.com/servetarslan02)[ RSS](/packages/hooksniff-hooksniff/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (2)Versions (5)Used By (0)

HookSniff PHP SDK
=================

[](#hooksniff-php-sdk)

 [![Latest Version](https://camo.githubusercontent.com/0100ddf275401bd7f870cdcab0fc867947c489304925d2a000f3c2a7134c03c1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f686f6f6b736e6966662f686f6f6b736e696666)](https://packagist.org/packages/hooksniff/hooksniff) [![Total Downloads](https://camo.githubusercontent.com/627ac16e5a79b3ca1d839c9a12eaddeaf320761821086df97879a863f61a4c3b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f686f6f6b736e6966662f686f6f6b736e696666)](https://packagist.org/packages/hooksniff/hooksniff) [![License](https://camo.githubusercontent.com/e04f74414b147410d2760a5affa97e31a300c8f004dc901dab64b3e5c3e56822/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7365727665746172736c616e30322f686f6f6b736e6966662d706870)](https://github.com/servetarslan02/hooksniff-php/blob/main/LICENSE) [![PHP Version](https://camo.githubusercontent.com/aa36f9f577bcc14d58c09769dd5ead33d0a531f97ec4253cc432a8997604d054/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e312d373737424234)](https://php.net)

Official PHP SDK for the [HookSniff](https://hooksniff.vercel.app) webhook delivery platform.

Installation
------------

[](#installation)

```
composer require hooksniff/hooksniff
```

Quick Start
-----------

[](#quick-start)

```
require 'vendor/autoload.php';

use HookSniff\HookSniff;
use HookSniff\Models\MessageIn;
use HookSniff\Models\EndpointIn;

// Initialize client
$client = new HookSniff("hs_xxx");

// Create an endpoint
$endpoint = $client->endpoint->create(
    new EndpointIn("https://example.com/webhook")
);

// Send a webhook
$message = $client->message->create(
    new MessageIn("user.created", ["email" => "user@example.com"])
);

// List deliveries
$attempts = $client->messageAttempt->listByEndpoint($endpoint->id);
```

Webhook Verification
--------------------

[](#webhook-verification)

```
use HookSniff\Webhook;

$wh = new Webhook("whsec_xxx");

$headers = [
    'hooksniff-id' => $_SERVER['HTTP_HOOKSNIFF_ID'],
    'hooksniff-timestamp' => $_SERVER['HTTP_HOOKSNIFF_TIMESTAMP'],
    'hooksniff-signature' => $_SERVER['HTTP_HOOKSNIFF_SIGNATURE'],
];

$payload = $wh->verify(file_get_contents('php://input'), $headers);
```

Authentication
--------------

[](#authentication)

```
use HookSniff\HookSniff;

// API Key authentication
$client = new HookSniff("sk_live_xxx");

// Custom server URL
use HookSniff\HookSniffOptions;

$options = new HookSniffOptions(
    serverUrl: 'https://your-instance.hooksniff.com'
);
$client = new HookSniff("sk_live_xxx", $options);
```

Resources
---------

[](#resources)

ResourceMethodsDescription**Admin**listUsers, getUserDetail, changePlan, changeStatus, impersonateUser, getSystemStats, getRevenue, getSettings, updateSettingsAdmin panel operations**Alert**list, create, get, update, delete, testAlert management**Analytics**deliveryTrend, successRate, latencyTrendDelivery analytics**ApiKey**list, create, delete, rotateAPI key management**Application**list, create, get, update, deleteApplication management**Authentication**register, login, logout, getMe, updateProfile, changePassword, forgotPassword, resetPassword, verifyEmail, enable2fa, confirm2fa, disable2fa, get2faStatusAuth &amp; 2FA**AuditLog**list, getAudit trail**BackgroundTask**list, get, cancelBackground task management**Billing**getSubscription, cancelSubscription, upgrade, openPortal, getUsage, getInvoices, getOverageSettingsBilling &amp; subscriptions**Connector**list, get, listConfigs, createConfig, getConfig, updateConfig, deleteConfigConnector management**CustomDomain**list, add, delete, verifyCustom domain management**Device**list, register, deletePush device management**Endpoint**list, create, get, update, delete, patch, getHeaders, updateHeaders, patchHeaders, getSecret, rotateSecret, sendExampleEndpoint CRUD**Environment**list, create, get, update, delete, listVariables, createVariable, updateVariable, deleteVariable, bulkUpsertVariablesEnvironment &amp; variables**EventType**list, create, get, update, delete, patch, importOpenapiEvent type management**Health**getHealth check**Inbound**listConfigs, createConfig, updateConfig, deleteConfig, handleInbound webhook configs**Integration**list, get, create, update, delete, test, listEvents, getStatsIntegration management**Message**list, create, getMessage dispatch**MessageAttempt**listByEndpoint, listByMsg, get, resendDelivery attempts**MessagePoller**poll, seek, commitMessage polling**Notification**list, unreadCount, markAllRead, markRead, deleteNotifications**OperationalWebhook**list, create, get, update, delete, listDeliveriesOperational webhooks**Portal**getConfig, updateConfig, getProfile, getUsage, getEmbedCodeCustomer portal**RateLimit**list, get, set, deleteRate limiting**Routing**get, update, getHealthEndpoint routing**Schema**list, register, get, validateSchema registry**Search**searchDelivery search**ServiceToken**list, create, delete, update, revealService tokens**Sso**getConfig, upsertConfig, deleteConfig, testConnectionSSO configuration**Statistics**aggregateAppStatsApp statistics**Stream**listChannels, getChannel, createChannel, updateChannel, deleteChannel, listMessages, listSubscriptions, disconnectSubscription, publishReal-time streaming**Team**list, create, get, acceptInvite, inviteMember, listMembers, removeMember, changeRoleTeam management**Template**list, get, applyWebhook templates**Transform**list, create, update, delete, testPayload transformsError Handling
--------------

[](#error-handling)

```
use HookSniff\Exception\ApiException;

try {
    $client->endpoint->get("nonexistent_id");
} catch (ApiException $e) {
    echo $e->getCode();    // HTTP status code
    echo $e->getMessage(); // Error message
}
```

Configuration
-------------

[](#configuration)

```
use HookSniff\HookSniffOptions;

$options = new HookSniffOptions(
    serverUrl: 'https://hooksniff-api-e6ztf3x2ma-ew.a.run.app',  // Custom server
    timeoutMs: 30000,                          // Request timeout
    numRetries: 2,                             // Retry count
    retryScheduleMs: [60, 120, 240],          // Retry delays
    debug: false,                              // Debug mode
);

$client = new HookSniff("sk_live_xxx", $options);
```

Debug Mode
----------

[](#debug-mode)

```
HOOKSNIFF_DEBUG=1 php your_script.php
```

Examples
--------

[](#examples)

See [EXAMPLES.md](EXAMPLES.md) for detailed usage examples covering all 35 resources.

Links
-----

[](#links)

- [Documentation](https://hooksniff.vercel.app/docs)
- [API Reference](https://hooksniff.vercel.app/docs)
- [GitHub](https://github.com/servetarslan02/hooksniff-php)
- [Packagist](https://packagist.org/packages/hooksniff/hooksniff)

License
-------

[](#license)

MIT

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance97

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 97% 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 ~3 days

Total

4

Last Release

22d ago

Major Versions

0.3.0 → 1.2.02026-05-18

PHP version history (2 changes)0.1.0PHP &gt;=8.0

1.2.0PHP &gt;=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/7bfcabc78b45993fc0d7c4c28af8175da420ecc2b1c0cf301dd3aabadb411379?d=identicon)[servetarslan02](/maintainers/servetarslan02)

---

Top Contributors

[![servetarslan02](https://avatars.githubusercontent.com/u/274024482?v=4)](https://github.com/servetarslan02 "servetarslan02 (32 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

---

Tags

httpapisdkwebhookshooksniffwebhook-delivery

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/hooksniff-hooksniff/health.svg)

```
[![Health](https://phpackages.com/badges/hooksniff-hooksniff/health.svg)](https://phpackages.com/packages/hooksniff-hooksniff)
```

###  Alternatives

[jlevers/selling-partner-api

PHP client for Amazon's Selling Partner API

4355.4M2](/packages/jlevers-selling-partner-api)[xeroapi/xero-php-oauth2

Xero official PHP SDK for oAuth2 generated with OpenAPI spec 3

1054.6M18](/packages/xeroapi-xero-php-oauth2)[onesignal/onesignal-php-api

A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com

34199.5k2](/packages/onesignal-onesignal-php-api)[zenditplatform/zendit-php-sdk

PHP client for Zendit API

1194.4k](/packages/zenditplatform-zendit-php-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
