Download the PHP package codepreneur/laravel-fathom without Composer
On this page you can find all versions of the php package codepreneur/laravel-fathom. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download codepreneur/laravel-fathom
More information about codepreneur/laravel-fathom
Files in codepreneur/laravel-fathom
Package laravel-fathom
Short Description A Laravel SDK for the Fathom AI API.
License MIT
Informations about the package laravel-fathom
Laravel Fathom
A Laravel SDK for the Fathom AI API.
Open-source Laravel SDK for the Fathom AI API — meetings, transcripts, summaries and webhooks.
Features
- Laravel-native facade and service provider with auto-discovery
- Typed DTOs with forward-compatible
raw()access - Cursor pagination support
- Webhook signature verification and middleware
- Rate limit exception with header details
- Comprehensive offline test suite
- No database dependency — storage-agnostic SDK
Requirements
- PHP 8.2+ (PHP 8.3+ required for Laravel 13)
- Laravel 11, 12, or 13
Installation
Publish the configuration (optional):
Fathom API Key
Generate an API key in your Fathom Settings → API Access.
Configuration
Add to your .env:
Configuration options in config/fathom.php:
| Key | Description | Default |
|---|---|---|
api_key |
Your Fathom API key | — |
base_url |
API base URL | https://api.fathom.ai/external/v1 |
timeout |
HTTP timeout in seconds | 30 |
webhook.secret |
Webhook signing secret | — |
webhook.tolerance |
Signature timestamp tolerance (seconds) | 300 |
Basic Usage
Meetings
Meeting Filtering
Meeting Types
Pagination
Fathom uses cursor-based pagination:
Transcripts
For async delivery, pass a destination_url:
Summaries
Recording Downloads
Teams
Team Members
Users
Admin-only endpoint for listing users and permissions:
Webhooks
Create a Webhook
Available triggered_for values:
my_recordingsshared_external_recordingsmy_shared_with_team_recordings(Team Plans)shared_team_recordings(Team Plans)
Delete a Webhook
Webhook Verification
Fathom signs webhooks using HMAC SHA-256. Verify incoming requests:
Parse webhook payloads:
Middleware
Register the middleware alias in your routes:
Events
Listen for webhook events:
Dispatch events manually:
Exceptions
| Exception | HTTP Status |
|---|---|
AuthenticationException |
401, 403 |
NotFoundException |
404 |
ValidationException |
422 |
RateLimitException |
429 |
FathomException |
Other |
Handle rate limits:
Rate Limits
Fathom enforces the following limits:
| Type | Limit |
|---|---|
| Global | 60 requests / 60 seconds |
| Heavy (transcript, summary, includes) | 30 requests / 60 seconds |
| Recording downloads | 30 requests / 60 seconds |
This package does not automatically retry rate-limited requests.
DTOs and Forward Compatibility
All responses are mapped to typed DTOs. Access unknown future API fields via raw():
Testing
The package includes a full offline test suite using Http::fake():
Contributing
See CONTRIBUTING.md.
Security
See SECURITY.md.
Changelog
See CHANGELOG.md.
License
The MIT License (MIT). See LICENSE for details.
All versions of laravel-fathom with dependencies
illuminate/http Version ^11.0|^12.0|^13.0
illuminate/support Version ^11.0|^12.0|^13.0
nesbot/carbon Version ^3.0