To access the Kivly API and receive Webhook events, you must authenticate using a client-based credential flow. This process ensures that only authorized integrations can interact with your account and receive event data securely.
🔐 How Authentication Works
Authentication is performed by sending a POST request with your credentials in the request body. You will receive a bearer token which must be included in the Authorization header of all subsequent requests.
🔧 Endpoint
POST /api/v1/auth/token
Content-Type: application/json
| Field | Type | Description |
|---|---|---|
client_id | string | Your unique client ID |
client_secret | string | Your secure client secret |
✅ Where to Get Your Credentials
Visit https://getkivly.com/dashboard/integrations/developers
Configure the webhook URL and select the events you wish to subscribe to.
Once saved, your client_id and client_secret will be generated and shown.
Store these securely — they are required to authenticate and receive events.