tools/sdk-php/crud-customer.md

---
title: CRUD Customer - Sage Intacct SDK for PHP | Sage Intacct Developer
url: https://developer.intacct.com/tools/sdk-php/crud-customer/
---

# CRUD Customer - Sage Intacct SDK for PHP | Sage Intacct Developer

Overview

Getting Started

List AR Invoices

List Vendors (Legacy)

CRUD Customer

Custom Object Function

Troubleshooting

* Prerequisites
* Run the example
* Extra credit
  + Get a customer by name
  + Try a different object
* What’s next?

---

This example shows you how to:

* Create a customer
* Read a customer
* Update a customer
* Delete a customer

---

## Prerequisites

* You have downloaded or cloned the Sage Intacct SDK for PHP examples.
* You successfully ran the getting started example—in particular, you set up the `.credentials.ini` file required by `bootstrap.php`.
* The user you are using has add, edit, delete, list, and view permissions for the customer object.

---

## Run the example

1. Run the `crud-customer.php` file:

   ```xml
   php crud-customer.php
   ```
2. Observe the terminal output.

   Information is echoed for each customer API function executed:

   ```xml
   Created inactive customer ID 10066
   Updated customer ID 10066 to active
   Read customer ID 10066
   Deleted customer ID 10066
      
   Process finished with exit code 0
   ```
3. Open the generated `logs/intacct.html` file in your browser and review the entries.

   The file provides info and debug entries. The SDK provides a debug entry for each HTTP request/response (with the Sage Intacct endpoint).

   Note that the log file was created by the logger set in the client config.

---

## Extra credit

### Get a customer by name

1. Execute a `ReadByName` function (instead of `Read`):

   ```xml
   $readByName = new ReadByName();
   $readByName->setObjectName('CUSTOMER');
   $readByName->setFields([
       'RECORDNO',
       'CUSTOMERID',
       'STATUS',
   ]);
   $readByName->setNames([
       $customerId,
   ]);
   $response = $client->execute($readByName);
   echo "Read customer ID $customerId using ReadByName" .  PHP_EOL;
   ```

### Try a different object

1. Try a different object’s CRUD functions from the `Intacct\Functions\` namespace.

---

## What’s next?

* Try an example that implements the `FunctionInterface` for use with a custom object.
* Browse the reference documentation for the SDK.

Provide feedback