Webhooks
Register event receivers, save signing secrets, and inspect delivery logs.
Webhooks send selected organization events to a receiver operated by your team. Open Webhooks in the bottom dock. Your developer can use the webhook integration guide and signature-verification example.
Before you begin
Section titled “Before you begin”Use an Owner or Finance role. Have your developer prepare an HTTPS receiver and a secure place for its signing secret.
Register an endpoint
Section titled “Register an endpoint”- Add the receiver
Click Add Webhook and enter the receiver’s HTTPS address in URL. Use an address controlled by your organization, such as
https://api.example.com/koneth/events. - Choose events
Select at least one event under Events. Choose only the events your application needs.
- Create and save the signing secret
Click Create. In Webhook Signing Secret, use Reveal secret and Copy. Store it securely, then click I have saved this secret.
- Arrange activation and verify receipt
Ask your Koneth contact to coordinate endpoint verification with your developer. After activation, compare delivery records with your receiver’s logs before depending on the integration.
The signing secret belongs in the receiver’s protected configuration. Do not use it as a Management API key or share it with traders.
Available events
Section titled “Available events”| Event | Availability |
|---|---|
position.opened |
Sent when a filled order creates a position. |
position.closed |
Sent when a position is fully closed. |
finance.transaction.completed |
Sent when a deposit or withdrawal is completed. |
Selecting an event subscribes the endpoint to that event type; it does not itself generate a delivery.
For continuous monitoring while positions are open, your developer can use Live account metrics.
Check delivery logs
Section titled “Check delivery logs”Find the endpoint row and click Deliveries. The Delivery Log shows event types and delivery statuses.
| Status shown | What to check |
|---|---|
| Success | Confirm your receiver accepted and processed the event as expected. |
| Failed | Investigate receiver availability and logs. Contact support if the state is unclear. |
| Dead letter | Delivery has stopped retrying. Ask your developer and Koneth contact to investigate. |
An empty log is not proof that the receiver is working. Check activation, event selection, and whether a relevant event has occurred. The dialog shows a limited recent history, not a complete delivery archive.
Manage an existing endpoint
Section titled “Manage an existing endpoint”Contact Koneth support if you need to activate, disable, replace, rotate the secret for, or redeliver an existing endpoint. Do not create duplicate endpoints as a substitute for managing an existing one.