Webhooks

{"feature":"webhooks","audience":"end_users","apps":["NextJS","Laravel"],"tags":["webhooks","integrations","notifications"]}

Organization Webhooks (Outbound)

Where in Kraya
- Page: https://kraya-ai.com/dashboard/webhooks (Admin-only)
What it does
- Lets your organization receive outbound events from Kraya at your own HTTPS endpoint.
- Typical events include lead creates and lead updates.

Overview

Configure a single webhook URL and secret for your organization. When certain actions occur (like a lead being created or updated), Kraya POSTs a JSON payload to your URL so you can process it in your own systems.

Setup

Open the Webhooks page (Admin)
Toggle Active, enter your HTTPS URL, and set a Secret (store it securely).
Save and copy values
Use the copy buttons next to your URL/Secret to configure your server.
Test
Create or update a lead in Kraya and check your server logs for incoming requests.

Notes

Only one webhook per organization.
Your endpoint should respond with 2xx quickly. Kraya may retry on transient failures.

Payloads (user view)

Format: JSON object containing the lead and its key fields (e.g., name, email, phone, notes, pipeline_id, stage_id, attributes).
Authentication: Use the secret you set in Kraya to verify requests on your server (e.g., compare a shared secret header or signature if you configure one server-side).

Edge cases to expect

Endpoint down / slow
- You may miss events or see retries delayed. Make sure your server responds fast.
Secret rotated
- Update your server to accept the new secret immediately.
Large volume
- Process asynchronously on your side to avoid timing out.

Troubleshooting (quick)

“No events received”
- Confirm the webhook is Active. Re-check the exact URL and that your firewall allows inbound requests.
“Weird data format”
- Log the full JSON to inspect. Only key lead fields are included; extend processing on your end as needed.

Short decision tree

Nothing received → Verify Active → Double-check URL/secret → Generate a small lead update → Inspect server logs.
Intermittent failures → Add retry handling / queue on your server → Keep responses < 1–2 seconds.

FAQs

Can I configure multiple webhook URLs?
- Not currently. Use your own relay service if you need to broadcast to multiple systems.
Can I choose events?
- Kraya sends standard lead events. Fine-grained selection is not exposed in the UI.

Connect Kraya (External API)
Google Sheets Integration