Skip to content
ClickFix
Sign inBook a demo
Documentation

Poll trigger events

View as MarkdownOpen in ChatGPTOpen in ClaudeFeedback
GET
/v1/public-api/triggers

Scope: triggers:read. Returns the events of the chosen type after cursor; send cursor=0 on the first call and keep the cursor from the response. Responses carry record ids, not conversation text. An expired cursor returns 410 CURSOR_EXPIRED.

Authorization

integrationKey
headerAuthorizationBearer <cf_sk_…>

Organization API key (cf_sk_…), created under Organization → API and automations → API keys and sent as Authorization: Bearer cf_sk_….

Query Parameters

event*string
Value in"conversation.created""conversation.resolved""contact.created""csat.submitted""conversation.tag_added"
cursor?string

Response Body

Success

application/json
  1. response
success*boolean
data*
meta*
Example Request
curl -X GET 'https://api.getclickfix.com/v1/public-api/triggers?event=conversation.created&cursor=0'
Example Response
{  "success": true,  "data": {    "items": [      {        "id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",        "event": "conversation.created",        "entity_uuid": "8f0e5c2a-6b1d-4f3a-9c7e-2d4b6a8c0e1f",        "occurred_at": "2026-11-11T09:15:00Z"      }    ],    "next_cursor": "1762852500000:2c3d4e5f",    "has_more": false,    "retention_days": 7  },  "meta": {    "request_id": "01JCK9ZQ3M8R2W7X5E4T1N0PAB"  }}