avaro/placetel-php-client

A PHP client library for the Placetel REST API

0.1.0-beta.1 2025-10-03 06:22 UTC

Requires

• php: ^8.0
• guzzlehttp/guzzle: ^7.10

MIT

• Jan Habbo Brüning

README

Placetel PHP Client is a modern, easy-to-use PHP package for integrating the Placetel REST API into your own applications or CRM systems. With this client, you can easily retrieve, create, update, and delete contacts, all through a clean, object-oriented API.

Features

• Fully CRUD-capable Contact Repository (create, getById, update, delete)
• Modern PHP 8+ design with namespaces and DTOs
• Composer-ready and immediately usable in your own projects

Installation

Install via Composer:

composer require avaro-crm/placetel-php-client

Quick Start

require 'vendor/autoload.php';

use Avaro\Placetel\Client;
use Avaro\Placetel\Entity\Contact;

$client = new Client(getenv('PLACETEL_API_TOKEN'));

// Retrieve all contacts
$contacts = $client->contacts()->all();
foreach ($contacts as $contact) {
    echo $contact->getFirstName() . ' ' . $contact->getLastName() . PHP_EOL;
}

// Create a new contact
$newContact = new Contact(
    firstName: "Anna",
    lastName: "Schmidt",
    email: "[e-mail]",
    company: "Avaro GmbH"
);

$created = $client->contacts()->create($newContact);
echo "Contact created with ID: " . $created->getId();

// Update a contact
$created->setEmail("[e-mail]");
$updated = $client->contacts()->update($created);

// Delete a contact
$client->contacts()->delete($updated->getId());