jeffersongoncalves / laravel-meta-ads

1.0.0 2026-09-07 21:30 UTC

Requires

• php: ^8.2
• illuminate/contracts: ^12.0|^13.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.21
• orchestra/testbench: ^10.0|^11.0
• pestphp/pest: ^3.0|^4.0
• pestphp/pest-plugin-laravel: ^3.0|^4.0

MIT

• Jefferson Simão Gonçalves

• laravel
• laravel-meta-ads

Published on Packagist.org on 2026-09-07 21:31 UTC

README

Laravel Meta Ads

Laravel integration for the Meta Ads (Facebook/Instagram Ads) Graph API

Installation

You can install the package via composer:

composer require jeffersongoncalves/laravel-meta-ads

Publish the config file:

php artisan vendor:publish --tag="laravel-meta-ads-config"

Set your credentials in .env:

META_ACCESS_TOKEN=
META_AD_ACCOUNT_ID=
META_ADS_API_VERSION=v18.0

Usage

use Jeffersongoncalves\LaravelMetaAds\Facades\LaravelMetaAds;

LaravelMetaAds::accounts();

LaravelMetaAds::campaigns(); // uses META_AD_ACCOUNT_ID by default
LaravelMetaAds::campaigns('123456789'); // or pass an ad account id explicitly

LaravelMetaAds::campaignInsights(campaignId: '120099', datePreset: 'last_30d');

LaravelMetaAds::createCampaign(name: 'My Campaign', objective: 'OUTCOME_TRAFFIC', status: 'PAUSED');

LaravelMetaAds::updateCampaignStatus(campaignId: '120099', status: 'ACTIVE');

LaravelMetaAds::adSets();

LaravelMetaAds::ads(adSetId: '120088');

LaravelMetaAds::audiences();

LaravelMetaAds::createLookalikeAudience(sourceId: '120077', country: 'US');

Every method returns an Illuminate\Http\Client\Response, so you can chain ->json(), ->throw(), etc.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email the author instead of using the issue tracker.

Credits

• jeffersongoncalves
• All Contributors

License

The MIT License (MIT). Please see License File for more information.