PHPackages                             m4l700/ac-php-wrapper - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. m4l700/ac-php-wrapper

ActiveLibrary[API Development](/categories/api)

m4l700/ac-php-wrapper
=====================

A simple wrapper to use the active campaign API

141PHP

Since Mar 2Pushed 3mo agoCompare

[ Source](https://github.com/m4lh700/activecampaign-php-wrapper)[ Packagist](https://packagist.org/packages/m4l700/ac-php-wrapper)[ RSS](/packages/m4l700-ac-php-wrapper/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependenciesVersions (1)Used By (0)

AC PHP Wrapper
==============

[](#ac-php-wrapper)

A simple PHP wrapper for the ActiveCampaign API v3.

Requirements
------------

[](#requirements)

- PHP 7.4 or higher
- cURL extension enabled

Installation
------------

[](#installation)

Install via Composer:

```
composer require m4l700/ac-php-wrapper
```

Usage
-----

[](#usage)

### Initialize the client

[](#initialize-the-client)

```
use m4l700\AcPhpWrapper\ApiClient;

$client = new ApiClient(
    apiUrl: 'https://youraccountname.api-us1.com',
    apiKey: 'your-api-key-here'
);
```

You can find your API URL and API key in your ActiveCampaign account under Settings > Developer.

### Available Methods

[](#available-methods)

#### Accounts

[](#accounts)

```
// Get all accounts
$accounts = $client->accounts->get();

// Get a single account by ID
$account = $client->accounts->getById(12345);

// Create a new account
$account = $client->accounts->create([
    'account' => [
        'name' => 'Account Name',
        'accountUrl' => 'https://example.com'
    ]
]);

// Update an account
$account = $client->accounts->update(12345, [
    'account' => [
        'name' => 'Updated Name'
    ]
]);

// Delete an account
$client->accounts->delete(12345);
```

#### Addresses

[](#addresses)

```
// Get all addresses
$addresses = $client->addresses->get();

// Get a single address by ID
$address = $client->addresses->getById(12345);

// Create a new address
$address = $client->addresses->create([
    'address' => [
        'address1' => '123 Main St',
        'city' => 'Chicago',
        'state' => 'IL',
        'zip' => '60601',
        'country' => 'US',
        'companyName' => 'My Company'
    ]
]);

// Update an address
$address = $client->addresses->update(12345, [
    'address' => [
        'city' => 'New York'
    ]
]);

// Delete an address
$client->addresses->delete(12345);
```

#### Automations

[](#automations)

```
// Get all automations
$automations = $client->automations->get();

// Get a single automation by ID
$automation = $client->automations->getById(12345);
```

#### Branding

[](#branding)

```
// Get all brandings
$brandings = $client->branding->get();

// Get a single branding by ID
$branding = $client->branding->getById(12345);

// Update a branding
$branding = $client->branding->update(12345, [
    'branding' => [
        'name' => 'My Brand'
    ]
]);
```

#### Campaigns

[](#campaigns)

```
// Get all campaigns
$campaigns = $client->campaigns->get();

// Get a single campaign by ID
$campaign = $client->campaigns->getById(12345);

// Get campaigns by user
$campaigns = $client->campaigns->getCampaignsByUser(1);

// Get users for a campaign
$users = $client->campaigns->getCampaignUsers(12345);

// Get automations for a campaign
$automations = $client->campaigns->getCampaignAutomations(12345);

// Get messages for a campaign
$messages = $client->campaigns->getCampaignMessages(12345);

// Get a single message for a campaign
$message = $client->campaigns->getCampaignMessage(12345);

// Get links for a campaign
$links = $client->campaigns->getCampaignLinks(12345);

// Create a campaign
$campaign = $client->campaigns->create([
    'campaign' => [
        'type' => 'single',
        'name' => 'My Campaign',
        'status' => 0
    ]
]);

// Update a campaign
$campaign = $client->campaigns->update(12345, [
    'campaign' => [
        'name' => 'Updated Campaign Name'
    ]
]);
```

#### Contacts

[](#contacts)

```
// Get all contacts
$contacts = $client->contacts->get();

// Get a single contact by ID
$contact = $client->contacts->getById(12345);

// Create a new contact
$contact = $client->contacts->create([
    'contact' => [
        'email' => 'john@example.com',
        'firstName' => 'John',
        'lastName' => 'Doe',
        'phone' => '555-555-5555'
    ]
]);

// Update a contact
$contact = $client->contacts->update(12345, [
    'contact' => [
        'firstName' => 'Jane'
    ]
]);

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

// Get contact data
$data = $client->contacts->getContactData(12345);

// Get contact tags
$tags = $client->contacts->getContactTags(12345);

// Add a tag to a contact
$client->contacts->createContactTag(contactId: 12345, tagId: 67);

// Remove a tag from a contact
$client->contacts->deleteContactTag(contactId: 12345, tagId: 67);

// Get contact lists
$lists = $client->contacts->getContactLists(12345);

// Add a contact to a list
$client->contacts->addContactToList(contactId: 12345, listId: 1);

// Get contact activity logs
$logs = $client->contacts->getContactLogs(12345);

// Get contact field values
$fieldValues = $client->contacts->getContactFieldValues(12345);
```

#### Forms

[](#forms)

```
// Get all forms
$forms = $client->forms->get();

// Get a single form by ID
$form = $client->forms->getById(12345);

// Update a form
$form = $client->forms->update(12345, [
    'form' => [
        'name' => 'Updated Form Name'
    ]
]);

// Delete a form
$client->forms->delete(12345);
```

#### Lists

[](#lists)

```
// Get all lists
$lists = $client->lists->get();

// Create a new list
$list = $client->lists->create([
    'list' => [
        'name' => 'My List',
        'stringid' => 'my-list',
        'sender_url' => 'https://example.com',
        'sender_reminder' => 'You signed up for this list.'
    ]
]);
```

#### Messages

[](#messages)

```
// Get all messages
$messages = $client->messages->get();

// Get a single message by ID
$message = $client->messages->getById(12345);

// Create a new message
$message = $client->messages->create([
    'message' => [
        'name' => 'My Email',
        'fromname' => 'John Doe',
        'fromemail' => 'john@example.com',
        'subject' => 'Hello!',
        'html' => 'Email content here'
    ]
]);

// Update a message
$message = $client->messages->update(12345, [
    'message' => [
        'subject' => 'Updated Subject'
    ]
]);

// Delete a message
$client->messages->delete(12345);
```

#### Tags

[](#tags)

```
// Get all tags
$tags = $client->tags->get();

// Get a single tag by ID
$tag = $client->tags->getById(12345);

// Create a tag
$tag = $client->tags->create([
    'tag' => [
        'tag' => 'my-tag',
        'tagType' => 'contact',
        'description' => 'My tag description'
    ]
]);

// Update a tag
$tag = $client->tags->update(12345, [
    'tag' => [
        'tag' => 'updated-tag-name'
    ]
]);

// Delete a tag
$client->tags->deleteTag(12345);

// Add a tag to a contact
$client->tags->addTagToContact(contactId: 12345, tagId: 67);
```

#### Templates

[](#templates)

```
// Get a single template by ID
$template = $client->templates->getById(12345);
```

#### Ecommerce

[](#ecommerce)

##### Connections

[](#connections)

```
// Get all connections
$connections = $client->ecommerce->connections->get();

// Get a single connection by ID
$connection = $client->ecommerce->connections->getById(12345);

// Create a new connection
$connection = $client->ecommerce->connections->create(
    service: 'shopify',
    externalId: 'store-123',
    name: 'My Store',
    logoUrl: 'https://example.com/logo.png',
    linkUrl: 'https://example.com'
);

// Update a connection
$connection = $client->ecommerce->connections->update(12345, [
    'connection' => [
        'name' => 'Updated Store Name'
    ]
]);

// Delete a connection
$client->ecommerce->connections->delete(12345);
```

##### Customers

[](#customers)

```
// Get all customers
$customers = $client->ecommerce->customers->get();

// Get a single customer by ID
$customer = $client->ecommerce->customers->getById(12345);

// Create a new customer
$customer = $client->ecommerce->customers->create(
    connectionId: 1,
    externalId: 456,
    email: 'customer@example.com',
    acceptsMarketing: true
);

// Update a customer
$customer = $client->ecommerce->customers->update(12345, [
    'ecomCustomer' => [
        'email' => 'newemail@example.com'
    ]
]);

// Delete a customer
$client->ecommerce->customers->delete(12345);
```

##### Orders

[](#orders)

```
// Get a single order by ID
$order = $client->ecommerce->orders->getById(12345);

// Create a new order
$order = $client->ecommerce->orders->create([
    'ecomOrder' => [
        'externalid' => 'order-123',
        'source' => 1,
        'email' => 'customer@example.com',
        'totalPrice' => 10000,
        'currency' => 'USD',
        'connectionid' => 1,
        'customerid' => 1
    ]
]);

// Update an order
$order = $client->ecommerce->orders->update(12345, [
    'ecomOrder' => [
        'totalPrice' => 15000
    ]
]);

// Delete an order
$client->ecommerce->orders->delete(12345);

// Create an abandoned cart
$cart = $client->ecommerce->orders->createAbandonedCart([
    'ecomOrder' => [
        'externalcheckoutid' => 'cart-123',
        'abandoned_date' => '2024-01-15T10:00:00-05:00',
        'email' => 'customer@example.com',
        'connectionid' => 1,
        'customerid' => 1
    ]
]);
```

##### Products

[](#products)

```
// Get all products
$products = $client->ecommerce->products->get();

// Get a single product by ID
$product = $client->ecommerce->products->getById(12345);
```

---

API Reference
-------------

[](#api-reference)

### Accounts

[](#accounts-1)

MethodParametersDescription`get()`noneRetrieve all accounts`getById(int $accountId)``$accountId`Retrieve a single account`create(array $data)``$data`Create a new account`update(int $accountId, array $data)``$accountId`, `$data`Update an account`delete(int $accountId)``$accountId`Delete an account### Addresses

[](#addresses-1)

MethodParametersDescription`get()`noneRetrieve all addresses`getById(int $addressId)``$addressId`Retrieve a single address`create(array $data)``$data`Create a new address`update(int $addressId, array $data)``$addressId`, `$data`Update an address`delete(int $addressId)``$addressId`Delete an address### Automations

[](#automations-1)

MethodParametersDescription`get()`noneRetrieve all automations`getById(int $automationId)``$automationId`Retrieve a single automation### Branding

[](#branding-1)

MethodParametersDescription`get()`noneRetrieve all brandings`getById(int $brandingId)``$brandingId`Retrieve a single branding`update(int $brandingId, array $data)``$brandingId`, `$data`Update a branding### Campaigns

[](#campaigns-1)

MethodParametersDescription`get()`noneRetrieve all campaigns`getById(int $campaignId)``$campaignId`Retrieve a single campaign`getCampaignsByUser(int $userId)``$userId`Retrieve campaigns by user`getCampaignUsers(int $campaignId)``$campaignId`Retrieve users for a campaign`getCampaignAutomations(int $campaignId)``$campaignId`Retrieve automations for a campaign`getCampaignMessages(int $campaignId)``$campaignId`Retrieve messages for a campaign`getCampaignMessage(int $campaignId)``$campaignId`Retrieve a single message for a campaign`getCampaignLinks(int $campaignId)``$campaignId`Retrieve links for a campaign`create(array $data)``$data`Create a new campaign`update(int $campaignId, array $data)``$campaignId`, `$data`Update a campaign### Contacts

[](#contacts-1)

MethodParametersDescription`get()`noneRetrieve all contacts`getById(int $contactId)``$contactId`Retrieve a single contact`create(array $data)``$data`Create a new contact`update(int $contactId, array $data)``$contactId`, `$data`Update a contact`delete(int $contactId)``$contactId`Delete a contact`getContactData(int $contactId)``$contactId`Retrieve contact data`getContactTags(int $contactId)``$contactId`Retrieve tags for a contact`createContactTag(int $contactId, int $tagId)``$contactId`, `$tagId`Add a tag to a contact`deleteContactTag(int $contactId, int $tagId)``$contactId`, `$tagId`Remove a tag from a contact`getContactLists(int $contactId)``$contactId`Retrieve lists for a contact`addContactToList(int $contactId, int $listId)``$contactId`, `$listId`Subscribe a contact to a list`getContactLogs(int $contactId)``$contactId`Retrieve activity logs for a contact`getContactFieldValues(int $contactId)``$contactId`Retrieve custom field values for a contact### Forms

[](#forms-1)

MethodParametersDescription`get()`noneRetrieve all forms`getById(int $formId)``$formId`Retrieve a single form`update(int $formId, array $data)``$formId`, `$data`Update a form`delete(int $formId)``$formId`Delete a form### Lists

[](#lists-1)

MethodParametersDescription`get()`noneRetrieve all lists`create(array $data)``$data`Create a new list### Messages

[](#messages-1)

MethodParametersDescription`get()`noneRetrieve all messages`getById(int $messageId)``$messageId`Retrieve a single message`create(array $data)``$data`Create a new message`update(int $messageId, array $data)``$messageId`, `$data`Update a message`delete(int $messageId)``$messageId`Delete a message### Tags

[](#tags-1)

MethodParametersDescription`get()`noneRetrieve all tags`getById(int $tagId)``$tagId`Retrieve a single tag`create(array $data)``$data`Create a new tag`update(int $tagId, array $data)``$tagId`, `$data`Update a tag`deleteTag(int $tagId)``$tagId`Delete a tag`addTagToContact(int $contactId, int $tagId)``$contactId`, `$tagId`Add a tag to a contact### Templates

[](#templates-1)

MethodParametersDescription`getById(int $templateId)``$templateId`Retrieve a single template### Ecommerce — Connections (`$client->ecommerce->connections`)

[](#ecommerce--connections-client-ecommerce-connections)

MethodParametersDescription`get()`noneRetrieve all connections`getById(int $connectionId)``$connectionId`Retrieve a single connection`create(string $service, string $externalId, string $name, string $logoUrl, string $linkUrl)``$service`, `$externalId`, `$name`, `$logoUrl`, `$linkUrl`Create a new connection`update(int $connectionId, array $data)``$connectionId`, `$data`Update a connection`delete(int $connectionId)``$connectionId`Delete a connection### Ecommerce — Customers (`$client->ecommerce->customers`)

[](#ecommerce--customers-client-ecommerce-customers)

MethodParametersDescription`get()`noneRetrieve all customers`getById(int $customerId)``$customerId`Retrieve a single customer`create(int $connectionId, int $externalId, string $email, bool $acceptsMarketing)``$connectionId`, `$externalId`, `$email`, `$acceptsMarketing` (default: `true`)Create a new customer`update(int $customerId, array $data)``$customerId`, `$data`Update a customer`delete(int $customerId)``$customerId`Delete a customer### Ecommerce — Orders (`$client->ecommerce->orders`)

[](#ecommerce--orders-client-ecommerce-orders)

MethodParametersDescription`getById(int $orderId)``$orderId`Retrieve a single order`create(array $data)``$data`Create a new order`update(int $orderId, array $data)``$orderId`, `$data`Update an order`delete(int $orderId)``$orderId`Delete an order`createAbandonedCart(array $data)``$data` (requires `externalcheckoutid`, `abandoned_date`)Create an abandoned cart### Ecommerce — Products (`$client->ecommerce->products`)

[](#ecommerce--products-client-ecommerce-products)

MethodParametersDescription`get()`noneRetrieve all products`getById(int $productId)``$productId`Retrieve a single productLicense
-------

[](#license)

MIT License

###  Health Score

20

—

LowBetter than 13% of packages

Maintenance53

Moderate activity, may be stable

Popularity9

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/c6e75dccef400959025b0370d6a511f1caf798045c9d6303937060c816c54e28?d=identicon)[m4lh700](/maintainers/m4lh700)

### Embed Badge

![Health badge](/badges/m4l700-ac-php-wrapper/health.svg)

```
[![Health](https://phpackages.com/badges/m4l700-ac-php-wrapper/health.svg)](https://phpackages.com/packages/m4l700-ac-php-wrapper)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35816.3M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24015.5M18](/packages/hubspot-api-client)[botman/driver-telegram

Telegram driver for BotMan

93452.6k6](/packages/botman-driver-telegram)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)