Webhooks allow TurtleApps to notify your systems when important events occur. Use webhooks to integrate with your existing tools, automate workflows, or build custom integrations.

What Are Webhooks?

Webhooks are HTTP callbacks that send real-time data to your specified URL when events happen in TurtleApps. Instead of polling for changes, your system receives instant notifications.

Webhook Flow Diagram

[Screenshot placeholder]

Setting Up Webhooks

To create a webhook:

Go to Settings → Integrations → Webhooks
Click "Add Webhook"
Enter your endpoint URL
Select which events to receive
Save and test the webhook

Available Events

You can subscribe to these webhook events:

ticket.created — New ticket submitted
ticket.completed — AI finished implementing
deployment.started — Deployment initiated
deployment.completed — Deployment finished
deployment.failed — Deployment encountered an error
approval.requested — Approval needed
approval.completed — Change was approved

💡Payload Format

All webhooks send JSON payloads with a consistent structure including event type, timestamp, and relevant data. See our API docs for full payload schemas.

Webhook Security

Each webhook includes a signature header for verification:

X-TurtleApps-Signature — HMAC-SHA256 signature
Verify using your webhook secret
Reject requests with invalid signatures

⚠️Always Verify

Always verify webhook signatures in production. This prevents attackers from sending fake webhook events to your endpoint.

Testing Webhooks

Use the "Send Test" button to send a sample event to your endpoint. This helps verify your integration is working correctly before real events occur.

Retry Policy

If your endpoint returns an error or is unavailable:

TurtleApps retries up to 5 times
Exponential backoff between retries
Failed webhooks are logged for debugging