İçeriğe geç
Dokümantasyon
GeliştiricilerAPI başvurusuŞirketler

Şirket zaman çizelgesine olay gönder

POST
/v1/public-api/company-events

Kapsam: events:write. Ürününüzdeki önemli bir olayı (ör. plan yükseltme, hata) şirketin zaman çizelgesine ekler. contact_email olayı bilinen bir kişiye bağlar. Tekrarlanan idempotency_key kayıtlı olayı duplicate: true ile döner.

Yetkilendirme

integrationKey
headerAuthorizationBearer <cf_sk_…>

Organizasyon API anahtarı (cf_sk_…). Organizasyon → API ve otomasyonlar → API anahtarları sayfasında oluşturulur; Authorization: Bearer cf_sk_… başlığıyla gönderilir.

Başlık parametreleri

Idempotency-Key*string
Lengthlength <= 200

İstek gövdesi

application/json
  1. body
company_uuid?string
Formatuuid
external_id?string
domain?string
contact_email?string
name*string
Length1 <= length <= 100
properties?
source?string
Lengthlength <= 32
Default"api"
idempotency_key?string
Lengthlength <= 200
occurred_at?string
Formatdate-time

Response Body

Tamam

application/json
  1. response
success*true
Value intrue
data*
meta*
Örnek istek
curl -X POST 'https://api.getclickfix.com/v1/public-api/company-events' \  -H 'Idempotency-Key: string' \  -H 'Content-Type: application/json' \  -d '{  "external_id": "F-77",  "name": "seat_limit_reached",  "properties": {    "seats": 12,    "limit": 12  },  "contact_email": "ayse@example.com",  "source": "billing",  "idempotency_key": "evt-2026-11-11-f77-seats",  "occurred_at": "2026-11-11T09:31:00Z"}'
Örnek yanıt
{  "success": true,  "data": {    "uuid": "9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",    "company_uuid": "0f9e8d7c-6b5a-4493-8271-605f4e3d2c1b",    "name": "seat_limit_reached",    "properties": {      "seats": 12,      "limit": 12    },    "source": "billing",    "occurred_at": "2026-11-11T09:31:00Z",    "duplicate": true  },  "meta": {    "request_id": "01JCK9ZQ3M8R2W7X5E4T1N0PAB"  }}