Skip to main content

Overview

Webhooks let external systems receive real-time notifications when events happen in your Tryno community. Use them to sync data, trigger automations, or integrate with your existing tools.

Available events

EventDescription
member.joinedA new member joined the community
member.leftA member left the community
post.createdA new post was published
post.deletedA post was removed
payment.completedA payment was confirmed
payment.refundedA refund was processed
challenge.enrolledA member enrolled in a challenge
challenge.completedA member completed a challenge
event.registeredA member registered for an event
event.checked_inA member checked in at an event

Configuration

1

Go to Settings

Navigate to Admin > Settings > Webhooks.
2

Add your endpoint URL

Enter the HTTPS URL where you want to receive webhook payloads.
3

Select events

Choose which events should trigger a notification to your endpoint.
4

Save and test

Save the configuration and click Test to send a sample payload to your endpoint.

Payload format

All webhooks follow a consistent JSON structure:
{
  "event": "member.joined",
  "timestamp": "2026-01-15T10:30:00Z",
  "data": {
    "community_id": "uuid",
    "user_id": "uuid",
    "metadata": {}
  }
}

Security

Each webhook request includes an X-Tryno-Signature header containing an HMAC-SHA256 signature. Use your webhook secret (provided when you create the endpoint) to verify that the request genuinely came from Tryno.
Always verify the X-Tryno-Signature header before processing a webhook payload. This prevents malicious actors from sending fake events to your endpoint.

Retry policy

If your endpoint returns an error (HTTP status >= 400), Tryno retries the delivery:
AttemptDelay
1st retryImmediate
2nd retry1 minute
3rd retry5 minutes
4th retry30 minutes
After 4 consecutive failures, the webhook is automatically disabled. You can re-enable it from the settings page after resolving the issue.