> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fusiondesk.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# FusionDesk Customers API — Create, Update & Delete

> Manage customers and directory records in FusionDesk using the REST API.

The Customers API allows you to manage customer directory records, including their contact details and profile fields.

***

## GET /customers

Retrieve a paginated list of customers in your organization.

<ParamField query="limit" type="integer" default="50">
  Number of customers to return per page. Maximum value is `50`.
</ParamField>

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.fusiondesk.in/v1/customers?limit=10" \
    -H "Authorization: Bearer fd_live_xxxxxxxxxxxxxxxxxxxx"
  ```

  ```json Response theme={null}
  [
    {
      "id": "cust_12345",
      "firstName": "Alex",
      "lastName": "Rivera",
      "email": "alex@company.com",
      "phone": "+15555555555",
      "image": "https://www.gravatar.com/avatar/...",
      "created": "2026-07-27T21:00:00.000Z",
      "modified": "2026-07-27T21:00:00.000Z"
    }
  ]
  ```
</CodeGroup>

***

## GET /customers/\{id}

Retrieve details for a single customer by ID.

<ParamField path="id" type="string" required>
  The unique ID of the customer.
</ParamField>

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.fusiondesk.in/v1/customers/cust_12345" \
    -H "Authorization: Bearer fd_live_xxxxxxxxxxxxxxxxxxxx"
  ```

  ```json Response theme={null}
  {
    "id": "cust_12345",
    "firstName": "Alex",
    "lastName": "Rivera",
    "email": "alex@company.com",
    "phone": "+15555555555",
    "image": "https://www.gravatar.com/avatar/...",
    "created": "2026-07-27T21:00:00.000Z",
    "modified": "2026-07-27T21:00:00.000Z"
  }
  ```
</CodeGroup>

***

## POST /customers

Create a new customer. Note that organizations on the **Free** plan are limited to a maximum of **100 customers**.

<ParamField body="firstName" type="string" required>
  The customer's first name.
</ParamField>

<ParamField body="lastName" type="string" required>
  The customer's last name.
</ParamField>

<ParamField body="email" type="string" required>
  The customer's email address.
</ParamField>

<ParamField body="phone" type="string">
  The customer's phone number.
</ParamField>

<ParamField body="imageUrl" type="string">
  Custom profile image URL.
</ParamField>

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.fusiondesk.in/v1/customers" \
    -H "Authorization: Bearer fd_live_xxxxxxxxxxxxxxxxxxxx" \
    -H "Content-Type: application/json" \
    -d '{
      "firstName": "Alex",
      "lastName": "Rivera",
      "email": "alex@company.com",
      "phone": "+15555555555"
    }'
  ```

  ```json Response theme={null}
  {
    "id": "cust_12345",
    "firstName": "Alex",
    "lastName": "Rivera",
    "email": "alex@company.com",
    "phone": "+15555555555",
    "created": "2026-07-27T21:05:00.000Z",
    "modified": "2026-07-27T21:05:00.000Z"
  }
  ```
</CodeGroup>

***

## PUT /customers/\{id}

Update an existing customer's properties.

<ParamField path="id" type="string" required>
  The unique ID of the customer.
</ParamField>

<ParamField body="firstName" type="string">
  The customer's first name.
</ParamField>

<ParamField body="lastName" type="string">
  The customer's last name.
</ParamField>

<ParamField body="phone" type="string">
  The customer's phone number.
</ParamField>

<CodeGroup>
  ```bash cURL theme={null}
  curl -X PUT "https://api.fusiondesk.in/v1/customers/cust_12345" \
    -H "Authorization: Bearer fd_live_xxxxxxxxxxxxxxxxxxxx" \
    -H "Content-Type: application/json" \
    -d '{
      "firstName": "Alexander"
    }'
  ```

  ```json Response theme={null}
  {
    "id": "cust_12345",
    "firstName": "Alexander",
    "lastName": "Rivera",
    "email": "alex@company.com",
    "phone": "+15555555555",
    "created": "2026-07-27T21:05:00.000Z",
    "modified": "2026-07-28T09:00:00.000Z"
  }
  ```
</CodeGroup>

***

## DELETE /customers/\{id}

Delete a customer record permanently.

<ParamField path="id" type="string" required>
  The unique ID of the customer.
</ParamField>

```bash theme={null}
curl -X DELETE "https://api.fusiondesk.in/v1/customers/cust_12345" \
  -H "Authorization: Bearer fd_live_xxxxxxxxxxxxxxxxxxxx"
```

A successful deletion returns `204 No Content` with an empty response body.