PHPackages                             helpscout/apps - 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. [API Development](/categories/api)
4. /
5. helpscout/apps

ActiveLibrary[API Development](/categories/api)

helpscout/apps
==============

Client library to assist with building dynamic apps that integrate with the Help Scout UI

1.1.1(8y ago)38404.7k↑18.5%5[1 PRs](https://github.com/helpscout/helpscout-apps-php/pulls)1MITPHPPHP >=5.3.2

Since May 30Pushed 2y ago45 watchersCompare

[ Source](https://github.com/helpscout/helpscout-apps-php)[ Packagist](https://packagist.org/packages/helpscout/apps)[ Docs](http://www.helpscout.net)[ RSS](/packages/helpscout-apps/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)Dependencies (1)Versions (6)Used By (1)

New Apps Platform Available! 🚀
==============================

[](#new-apps-platform-available-rocket)

> 📢 We're thrilled to announce that our new [App Developer Platform](https://developer.helpscout.com/apps/) is now available to all customers. We highly encourage all new apps to be built on the platform to take advantage of its expanded capabilities.
>
> For those looking to migrate from our legacy custom apps, we have prepared a comprehensive [Migration Guide](https://developer.helpscout.com/apps/guides/migrating-legacy-dynamic-apps/). This guide will help you seamlessly transition to the new platform.
>
> All existing legacy custom apps will continue to function as before. If you'd like to use the legacy framework to install a legacy custom app, click [here](https://secure.helpscout.net/apps/custom). You can still access the documentation for Legacy Custom Apps [here](https://developer.helpscout.com/apps/legacy-custom-apps/).

---

*Please note: While we will continue to support this legacy PHP library, future development will be focused on our new Apps Platform.*

Dynamic Apps Client Library
===========================

[](#dynamic-apps-client-library)

Client library to assist with building custom apps that integrate with [Help Scout](https://www.helpscout.net/). More information:

Current Version
---------------

[](#current-version)

- 1.1.1

Please see the [Changelog](https://github.com/helpscout/helpscout-apps-php/blob/master/CHANGELOG.md) for details.

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

[](#installation)

The Help Scout apps client can be installed using [Composer](https://packagist.org/packages/helpscout/apps).

### Composer

[](#composer)

Inside of composer.json specify the following:

```
{
  "require": {
    "helpscout/apps": "1.1.*"
  }
}

```

Example Usage (1)
-----------------

[](#example-usage-1)

```
use HelpScoutApp\DynamicApp;

include 'src/HelpScoutApp/DynamicApp.php';

$app = new DynamicApp('SECRET-KEY-HERE');
if ($app->isSignatureValid()) {
        $customer = $app->getCustomer();
        $user     = $app->getUser();
        $convo    = $app->getConversation();
        $mailbox  = $app->getMailbox();

        $html = array(
        	'Convo',
			'',
				'Id: ' . $convo->getId() . '',
                'Number: ' . $convo->getNumber() . '',
                'Subject: ' . $convo->getSubject() . '',
            '',
			'Customer',
			'',
				'First: ' . $customer->getFirstName() . '',
                'Last: ' . $customer->getLastName() . '',
                'Email: ' . $customer->getEmail() . '',
			'',
			'User',
			'',
                'First: ' . $user->getFirstName() . '',
                'Last: ' . $user->getLastName() . '',
                'Id: ' . $user->getId() . '',
			'',
			'Mailbox',
			'',
			    'ID: ' . $mailbox->getId() . '',
			    'Email: ' . $mailbox->getEmail() . '',
			''
        );
        echo $app->getResponse($html);
} else {
        echo 'Invalid Request';
}

```

Example Usage (2)
-----------------

[](#example-usage-2)

```
use HelpScoutApp\DynamicApp;

include 'src/HelpScoutApp/DynamicApp.php';

$app = new DynamicApp('SECRET-KEY-HERE');
if ($app->isSignatureValid()) {
    echo $app->getResponse('Hello World');
} else {
    echo 'Invalid Request';
}

```

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity47

Moderate usage in the ecosystem

Community24

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 67.7% 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 ~469 days

Total

4

Last Release

2964d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ebe68856d5769ac3eda6c6ebef50a91ec2f3983df668ff7afedf8bfc561da250?d=identicon)[dswindle](/maintainers/dswindle)

![](https://www.gravatar.com/avatar/06719ba09ce20c0774f7b29346b41890f497cb06252f3b8b701fd0df32abd082?d=identicon)[craig-davis](/maintainers/craig-davis)

![](https://www.gravatar.com/avatar/2a560935372705d52a621836e7bee49a6d6576c646bc87feb4c7832baf9e8fc0?d=identicon)[helpscout](/maintainers/helpscout)

---

Top Contributors

[![dswindle](https://avatars.githubusercontent.com/u/2071187?v=4)](https://github.com/dswindle "dswindle (21 commits)")[![stevenwadejr](https://avatars.githubusercontent.com/u/1508485?v=4)](https://github.com/stevenwadejr "stevenwadejr (7 commits)")[![tamarazuk](https://avatars.githubusercontent.com/u/3422554?v=4)](https://github.com/tamarazuk "tamarazuk (2 commits)")[![janpio](https://avatars.githubusercontent.com/u/183673?v=4)](https://github.com/janpio "janpio (1 commits)")

---

Tags

helpscoutappsdynamic-app

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)[helpscout/api

Help Scout API v2 Client

1002.1M4](/packages/helpscout-api)[hubspot/api-client

Hubspot API client

23914.2M16](/packages/hubspot-api-client)

PHPackages © 2026

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