README.md

Mailcow PHP API Client

Getting Started

Requirements

• PHP 7.2+
• Extensions: Composer, PHP-JSON

In the root of your project execute the following:

$ composer require exbil/mailcow-php-api

or add this to your composer.json file:

{
    "require": {
        "exbil/mailcow-php-api": "^0.14.1"
    }
}

Then perform the installation:

$ composer install --no-dev

Usage

Search for the API Documentation here or your own mailcow instance via https://domain.com/api.
You need an API Key for that which can be found in an self-hosted instance within the admin dashboard.

Example

<?php
// Require the autoloader
require_once 'vendor/autoload.php';

// Use the library namespace
use Exbil\MailCowAPI;

// Then simply pass your API-Token when creating the API client object.
$client = new MailCowAPI('mailcow-with-https.example.com','MAILCOW_API_KEY');

// Then you are able to perform a request
var_dump($client->domains()->getDomains());
?>