PHPackages                             helgesverre/snov-io - 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. helgesverre/snov-io

ActiveLibrary[API Development](/categories/api)

helgesverre/snov-io
===================

PHP/Laravel SDK for the Snov.io API

v1.0.1(2y ago)2181[1 PRs](https://github.com/HelgeSverre/snov-io/pulls)MITPHPPHP ^8.2

Since Feb 16Pushed 2y ago2 watchersCompare

[ Source](https://github.com/HelgeSverre/snov-io)[ Packagist](https://packagist.org/packages/helgesverre/snov-io)[ Docs](https://github.com/helgesverre/snov-io)[ RSS](/packages/helgesverre-snov-io/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (14)Versions (3)Used By (0)

[![](./art/header.png)](./art/header.png)

Laravel Client for Snov.io
==========================

[](#laravel-client-for-snovio)

[![Latest Version on Packagist](https://camo.githubusercontent.com/901963adb557be8dc8b0e3754c9ca3f5c24dd411b42af99a6284cde1c9536351/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f68656c67657376657272652f736e6f762d696f2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/helgesverre/snov-io)[![Total Downloads](https://camo.githubusercontent.com/76d8aa8e9159f04f6ee19b69ce7912dd1f3592961cf3dc38b487d2e6f1115745/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f68656c67657376657272652f736e6f762d696f2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/helgesverre/snov-io)

The Snov.io Laravel Client enables laravel applications to interact with the [Snov.io API](https://snov.io/api).

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

[](#installation)

You can install the package via composer:

```
composer require helgesverre/snov-io
```

You can publish the config file with:

```
php artisan vendor:publish --tag="snov-io"
```

This is the contents of the published config file:

```
return [
    'client_id' => env('SNOV_CLIENT_ID'),
    'client_secret' => env('SNOV_CLIENT_SECRET'),
];
```

Usage
-----

[](#usage)

### Creating an authenticated client

[](#creating-an-authenticated-client)

```
use HelgeSverre\Snov\Snov;

// Instantiate the client
$snov = new Snov(
    clientId: config('snov-io.client_id'),
    clientSecret: config('snov-io.client_secret'),
);

// Authenticate the client
$snov->authenticate($snov->getAccessToken());

// Call the API with a request
$snov->send(new EmailCountRequest(
    domain: "snov.io",
));
```

Creating an authenticated client is only necessary if you want to use the client to send individual requests manually, if you use the resource methods on the Snov class, the client will be authenticated automatically.

```
$snov = new Snov(
    clientId: config('snov-io.client_id'),
    clientSecret: config('snov-io.client_secret'),
);

// No need to authenticate the client, the resource method will do it automatically
$snov->emailFinder()->emailCount(
    domain: "snov.io",
);
```

### Using the Facade

[](#using-the-facade)

You can also use the Facade to access the Snov.io API.

```
Snov::dripCampaigns();
Snov::emailFinder();
Snov::emailVerifier();
Snov::prospectManagement();
Snov::userAccount();
```

### Resource: Drip Campaigns

[](#resource-drip-campaigns)

```
Snov::dripCampaigns()->changeRecipientsStatus($email, $campaignId, $status);
Snov::dripCampaigns()->seeListOfCompletedProspects($campaignId);
Snov::dripCampaigns()->seeCampaignReplies($campaignId);
Snov::dripCampaigns()->getInfoAboutCampaignOpens($campaignId);
Snov::dripCampaigns()->checkLinkClicks($campaignId);
Snov::dripCampaigns()->viewSentEmails($campaignId);
Snov::dripCampaigns()->addToDoNotEmailList($items, $listId);
```

### Resource: Email Finder

[](#resource-email-finder)

```
Snov::emailFinder()->domainSearchV2($domain, $type, $limit, $lastId, $positions);
Snov::emailFinder()->emailCount($domain);
Snov::emailFinder()->emailFinder($firstName, $lastName, $domain);
Snov::emailFinder()->addNamesToFindEmails($firstName, $lastName, $domain);
Snov::emailFinder()->addURLToSearchForProspect($url);
Snov::emailFinder()->getProspectWithURL($url);
Snov::emailFinder()->getProfileWithEmail($email);
```

### Resource: Email Verifier

[](#resource-email-verifier)

```
Snov::emailVerifier()->emailVerifier($emails)
Snov::emailVerifier()->addEmailsForVerification($emails)
```

### Resource: Prospect Management

[](#resource-prospect-management)

```
Snov::prospectManagement()->addProspectToList(
    $email,
    $fullName,
    $firstName,
    $lastName,
    $phones,
    $country,
    $locality,
    $position,
    $companyName,
    $companySite,
    $updateContact,
    $customFields,
    $socialLinks,
    $listId,
);
Snov::prospectManagement()->findProspectByID($id);
Snov::prospectManagement()->findProspectByEmail($email);
Snov::prospectManagement()->viewProspectsInList($listId, $page, $perPage);
Snov::prospectManagement()->createNewProspectList($name);
```

### Resource: Prospect Management

[](#resource-prospect-management-1)

```
Snov::userAccount()->checkUserBalance();
```

### Resource: Webhooks

[](#resource-webhooks)

```
Snov::webhooks()->listAllWebhooks();
Snov::webhooks()->addWebhook($eventObject, $eventAction, $endpointUrl,);
Snov::webhooks()->changeWebhookStatus($status,);
Snov::webhooks()->deleteAWebhook();
```

Development
-----------

[](#development)

Snov.io does not have an API specification publicly available, however their API docs are fairly structured and can be scraped to generate something resembling an API spec that can be used to auto-generate parts of this SDK.

### Resource: Code generation

[](#resource-code-generation)

Run code generation with the composer script `codegen` using this command:

```
composer codegen
```

Which runs these tasks:

```
# Generate the API spec
php ./bin/generate.php

# Generate the Resource and Request classes from the API spec
php ./bin/codegen.php

# Format the generated code
composer format
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity55

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 ~0 days

Total

2

Last Release

815d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/68f3958f40262d577ddc0596e4ba78b42c0409ebc7de948bab47edee392d5f68?d=identicon)[HelgeSverre](/maintainers/HelgeSverre)

---

Top Contributors

[![HelgeSverre](https://avatars.githubusercontent.com/u/1089652?v=4)](https://github.com/HelgeSverre "HelgeSverre (24 commits)")

---

Tags

apilaravelsdksnov.io

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/helgesverre-snov-io/health.svg)

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

###  Alternatives

[helgesverre/mistral

Laravel Client for the Mistral.ai API

5213.5k1](/packages/helgesverre-mistral)

PHPackages © 2026

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