Webhook aboneliği oluştur

POST

/v1/public-api/webhooks

Kapsam: webhooks:write. Adres herkese açık bir HTTPS adresi olmalıdır. İmza anahtarı (secret) yalnızca bu yanıtta döner. Idempotency-Key zorunludur.

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

İstek gövdesi

application/json

body

name*string

Length1 <= length <= 120

url*string

Herkese açık HTTPS adresi. Özel adresler, yönlendirmeler ve DNS rebinding engellenir.

Formaturi

events*array<string>

Items1 <= items

enabled*boolean

Response Body

Başarılı

application/json

response

success*boolean

data*unknown

meta?

Örnek istek

curl -X POST 'https://api.getclickfix.com/v1/public-api/webhooks' \
  -H 'Idempotency-Key: string' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "ERP sync",
  "url": "https://erp.example.com/clickfix/webhook",
  "events": [
    "conversation.created",
    "message.received",
    "contact.updated"
  ],
  "enabled": true
}'

Örnek istek

curl -X POST 'https://api.getclickfix.com/v1/public-api/webhooks' \  -H 'Idempotency-Key: string' \  -H 'Content-Type: application/json' \  -d '{  "name": "ERP sync",  "url": "https://erp.example.com/clickfix/webhook",  "events": [    "conversation.created",    "message.received",    "contact.updated"  ],  "enabled": true}'

Örnek yanıtSchema

{
  "success": true,
  "data": {
    "uuid": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
    "name": "ERP sync",
    "url": "https://erp.example.com/clickfix/webhook",
    "events": [
      "conversation.created",
      "message.received",
      "contact.updated"
    ],
    "enabled": true,
    "created_at": "2026-11-01T10:00:00Z",
    "secret": "whsec_3f9c1a7e5b2d4c8f0a6e9b1d3c5f7a2e4b6d8c0f1a3e5b7d9c2f4a6e8b0d1c3f"
  },
  "meta": {
    "request_id": "01JCK9ZQ3M8R2W7X5E4T1N0PAB"
  }
}

{  "success": true,  "data": {    "uuid": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",    "name": "ERP sync",    "url": "https://erp.example.com/clickfix/webhook",    "events": [      "conversation.created",      "message.received",      "contact.updated"    ],    "enabled": true,    "created_at": "2026-11-01T10:00:00Z",    "secret": "whsec_3f9c1a7e5b2d4c8f0a6e9b1d3c5f7a2e4b6d8c0f1a3e5b7d9c2f4a6e8b0d1c3f"  },  "meta": {    "request_id": "01JCK9ZQ3M8R2W7X5E4T1N0PAB"  }}

Webhook aboneliği oluştur

YetkilendirmeBağlantıyı kopyala

Başlık parametreleriBağlantıyı kopyala

İstek gövdesiBağlantıyı kopyala

Response BodyBağlantıyı kopyala

Yetkilendirme

Başlık parametreleri

İstek gövdesi

Response Body