About Webhooks

Webhooks allow you to get programmatical notifications from Tribe about changes to your data as they happen. If you're new to webhooks, read this guide to learn more.

Rather than requiring you to pull information via our API, webhooks will push information to your endpoint. When one of those events is triggered (for example a new post is created), Tribe will send this notification as an HTTP POST request, with a JSON body, to the endpoint(s) you specify.

Adding Webhooks

You can create a new webhook by installing the Webhooks app from Tribe app store and clicking on + Add Webhook button on the Webhook app settings.

🚧

Webhooks are called only when the Enabled checkbox is checked under the Webhook app settings.

On the Create Webhook modal you can pick the multiple events. Events define when your endpoint should be called. You can enter your endpoint under URL.

The Token is an optional secret value sent to your endpoint as token. You can validate the value of the token to make sure the request came from Tribe.

Webhook Format

All webhook requests include the following body fields:

{
  "actor": {
    "_id": "Actor's User ID",
    "email": "Actor's Email",
    "externalId": "Actor's External ID",
    "role": "Actor's Role",
    "profile": {
      "username": "Actor's Username",
      "name": "Actor's name",
      // ... the rest of actor's properties
    }
  },
  "event": "the webhook event", // e.g. post.create
  "createdAt": 1587602719, // Event creation timestamp
  "token": "S3cr3t_T0k3n",
  // ... extra properties based on the event
}

The actor is the user object of the person who performed the action resulting in the webhook request.

Based on the event that generated the webhook request there will be extra parameters in the request body.

Retry logic

Webhooks retry policy is as follows:

• In case the original notification sending attempt fails (due to receiving a non-2xx response code or exceeding timeout of 60 seconds), we will try 4 more times: after 5, 25, 125, 625 seconds. If it still fails for each of those attempts, it is counted as one non-successful delivery.
• If there are no successful deliveries on 3 consecutive days, we will delete this specific webhook.