FusionDesk Customers API — Create, Update & Delete

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.

integer

default:"50"

Number of customers to return per page. Maximum value is 50.

curl -X GET "https://api.fusiondesk.in/v1/customers?limit=10" \
  -H "Authorization: Bearer fd_live_xxxxxxxxxxxxxxxxxxxx"

[
  {
    "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"
  }
]

GET /customers/{id}

Retrieve details for a single customer by ID.

string

required

The unique ID of the customer.

curl -X GET "https://api.fusiondesk.in/v1/customers/cust_12345" \
  -H "Authorization: Bearer fd_live_xxxxxxxxxxxxxxxxxxxx"

{
  "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"
}

POST /customers

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

string

required

The customer’s first name.

string

required

The customer’s last name.

string

required

The customer’s email address.

string

The customer’s phone number.

string

Custom profile image URL.

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"
  }'

{
  "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"
}

PUT /customers/{id}

Update an existing customer’s properties.

string

required

The unique ID of the customer.

string

The customer’s first name.

string

The customer’s last name.

string

The customer’s phone number.

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"
  }'

{
  "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"
}

DELETE /customers/{id}

Delete a customer record permanently.

string

required

The unique ID of the customer.

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.

Overview

Endpoints

FusionDesk Customers API — Create, Update & Delete

GET /customers

GET /customers/{id}

POST /customers

PUT /customers/{id}

DELETE /customers/{id}

​GET /customers

​GET /customers/{id}

​POST /customers

​PUT /customers/{id}

​DELETE /customers/{id}

GET /customers

GET /customers/{id}

POST /customers

PUT /customers/{id}

DELETE /customers/{id}