Welcome to the official documentation for notion-sdk-php, a comprehensive PHP library for interacting with the Notion API. This SDK provides a clean, object-oriented interface to all Notion API endpoints, making it easy to build powerful integrations with Notion workspaces.

What is notion-sdk-php?

notion-sdk-php is the unofficial PHP implementation of the Notion SDK, designed to provide PHP developers with a robust and intuitive way to work with Notion’s API. The library follows modern PHP best practices, implements PSR standards, and provides comprehensive error handling and type safety.

Key Features

Complete API Coverage: Support for all Notion API endpoints (pages, databases, blocks, users, comments, search)

Type Safety: Strongly typed resource objects with full IDE support

PSR Compliance: Follows PSR-18 for HTTP clients and PSR-4 for autoloading

Flexible HTTP Client: Works with any PSR-18 compatible HTTP client (Guzzle, Symfony, cURL)

Comprehensive Error Handling: Detailed exception hierarchy for robust error management

Pagination Support: Built-in pagination handling for large result sets

Rate Limiting: Tools and patterns for handling API rate limits gracefully

Ready to get started? Head over to the Installation to begin!

Pages