API Reference

Integrate Client Cove into your existing tools and workflows using the REST API. All endpoints return JSON and require authentication.

API access is available on Pro and Enterprise plans. Generate an API key from Settings then API Keys.

Authentication

All API requests require a Bearer token in the Authorization header. Pass your API key with every request.

curl -X GET https://api.clientcove.com/v1/tickets \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

If your token is invalid or expired, the API returns a 401 error:

{
  "error": "unauthorized",
  "message": "Invalid or expired API key. Generate a new key in Settings."
}

Tickets

List all tickets

Retrieve a paginated list of tickets for your organization.

Name
status
Type
string
Description
Filter by ticket status: open, in_progress, resolved, or closed.
Name
page
Type
integer
Description
Page number for pagination. Defaults to 1.
Name
per_page
Type
integer
Description
Number of results per page. Maximum 100, defaults to 25.

Response

{
  "data": [
    {
      "id": "tkt_29a3b8c",
      "subject": "Login issues on mobile",
      "status": "open",
      "priority": "high",
      "created_at": "2026-02-25T14:30:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 42
  }
}

Create a ticket

Submit a new support ticket programmatically.

Create a ticket

curl -X POST https://api.clientcove.com/v1/tickets \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Cannot upload files over 10MB",
    "description": "When I try to upload a PDF larger than 10MB, the upload fails silently.",
    "priority": "medium"
  }'

File Uploads

Upload files and attach them to tickets or shared folders.

Upload a file

curl -X POST https://api.clientcove.com/v1/files \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf" \
  -F "folder_id=fld_8x92k"

The response includes the file metadata:

Response

{
  "id": "file_4m9xq",
  "filename": "document.pdf",
  "size_bytes": 2048576,
  "mime_type": "application/pdf",
  "folder_id": "fld_8x92k",
  "uploaded_at": "2026-02-27T10:15:00Z",
  "download_url": "https://files.clientcove.com/file_4m9xq/document.pdf"
}

Webhooks

Receive real-time notifications when events occur in your Client Cove account.

Register a webhook

curl -X POST https://api.clientcove.com/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/clientcove",
    "events": ["ticket.created", "ticket.updated", "file.uploaded"]
  }'

Webhook payload

When an event fires, Client Cove sends a POST request to your URL:

Webhook payload

{
  "event": "ticket.created",
  "timestamp": "2026-02-27T10:30:00Z",
  "data": {
    "id": "tkt_29a3b8c",
    "subject": "Login issues on mobile",
    "status": "open",
    "priority": "high",
    "created_by": "user_k8m2x"
  }
}

Webhooks are retried up to 3 times with exponential backoff if your endpoint returns a non-2xx status code.