Authentication

Configure your Paubox API credentials for the PHP SDK.

Obtain your credentials

The Email API client requires two credentials:

• API key: a secret token that authenticates your requests
• Username: your Paubox API endpoint username (not your login email)

Both are available in the Paubox dashboard under API Credentials.

Create a .env file

Add your credentials to a .env file at your project root:

PAUBOX_API_KEY=YOUR_API_KEY
PAUBOX_API_USER=YOUR_USERNAME

The SDK reads these variables automatically on instantiation; no constructor arguments are needed:

$paubox = new Paubox\Paubox();

The SDK sets the Authorization header on every request:

Authorization: Token token=YOUR_API_KEY

Forms client

Paubox\PauboxForms requires no credentials. Form submissions are associated with the form ID, not an API key.

$forms = new Paubox\PauboxForms();

Security notes

• Never commit .env files to source control. Add .env to your .gitignore.
• The SDK does not expose credentials in error messages or logs.