laravel-meta-ads maintained by jeffersongoncalves
Description
Laravel integration for the Meta Ads (Facebook/Instagram Ads) Graph API
Author
Last update
2026/09/29 02:24
(dev-main)
License
Downloads
2
Tags

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
License
The MIT License (MIT). Please see License File for more information.