Webhooks

Warning

Webhooks are only available for enterprise accounts.

Webhooks are a technique of programming that allows a web application to receive real-time notifications of events from another application. In other words, webhooks allow two applications to communicate with each other.

Webhooks configuration

The webhooks are available only for organizations, so the events will be triggered when something happens in a resource owned by that organization.

The webhook configuration has 2 important fields:

• url: The URL that will be used to send a webhook.
• password (optional): This will allow webhook receivers to verify that the webhook is coming from TimeTime and not from a bad actor that discovered the webhook receiver URL. The password will be securely stored in TimeTime, and then appended as a header in each webhook delivery, the header name is X-TT-Webhook-Password.

Webhooks delivery order

TimeTime will send webhooks to your org one by one, reducing the chances of race conditions on your side. No webhooks will be sent if there is one webhook delivery in process.

Webhooks retries

TimeTime will perform 10 attempts to deliver a webhook. To allow your server recover from a temporary issue, TimeTime will apply an exponential backoff between retries. The initial delay will be 200ms, and it'll be doubling that till reaching the 10 attempts (with a maximum delay of 10 seconds).

After exhausting all the attempts, TimeTime won't try again to send this webhook, and it'll move on to the next one. Here we're making a decision in favor the "availability" over "consistency", we prefer to move one instead of "stopping the world" so your system keep receiving webhooks, at the chance of losing some of them.

TimeTime will securely store the webhook payloads, so if you missed some webhooks and really need them, contact us so we can consider retrying those ones.

Available webhooks

TimeTime offers webhooks for some events happening in the system, full list with OpenApi docs can be found here.

• CalendarEventChanged: Triggered when a calendar event is created or updated.
• BookingChanged: Triggered when a booking is created or updated in any way, such as an status change (confirmed, canceled, etc).
• UpcomingBooking: Sent if "webhook" reminders are enabled in your tenant (enterprise customers only), then the webhook will be sent respecting the time configured in the event type settings.

Examples

{
  "type": "BookingChanged",
  "new": {
    "id": "90b33f62-0347-4ad8-b63a-88eab21df3ee",
    "eventType": {
      "id": "ed19c788-e869-4de4-81ec-ec0d2ba748cf",
      "name": "Reunión con Odín del Río Piñeiro",
      "owner": {
        "type": "BookedEventTypeOwnerUser",
        "id": "54330e53-e9b9-430c-a417-7efaa87f39f7",
        "email": "odin@timetime.in",
        "externalId": null
      },
      "tags": {}
    },
    "interval": {
      "start": "2025-01-19T11:45:00Z",
      "end": "2025-01-19T11:55:00Z"
    },
    "booker": {
      "email": "odin+booker@timetime.in"
    },
    "answeredQuestions": [
      {
        "id": "tt_booker_email",
        "label": "Correo electrónico",
        "answer": "odin+booker@timetime.in"
      },
      {
        "id": "8f3e67b3-c381-4fb0-8197-dc53f73aa633",
        "label": "Nombre",
        "answer": "odinnn test"
      }
    ],
    "notes": "",
    "units": 1,
    "cancellation": null,
    "bookedResources": [],
    "conferenceLink": null,
    "privateNotes": [],
    "status": "CONFIRMED",
    "price": null,
    "confirmedAt": "2025-01-19T11:42:32.234713Z",
    "heldUntil": null
  },
  "old": null
}

{
  "type": "UpcomingBooking",
  "booking": {
    "id": "90b33f62-0347-4ad8-b63a-88eab21df3ee",
    "eventType": {
      "id": "ed19c788-e869-4de4-81ec-ec0d2ba748cf",
      "name": "Reunión con Odín del Río Piñeiro",
      "owner": {
        "type": "BookedEventTypeOwnerUser",
        "id": "54330e53-e9b9-430c-a417-7efaa87f39f7",
        "email": "odin@timetime.in",
        "externalId": null
      },
      "tags": {}
    },
    "interval": {
      "start": "2025-01-19T11:45:00Z",
      "end": "2025-01-19T11:55:00Z"
    },
    "booker": {
      "email": "odin+booker@timetime.in"
    },
    "answeredQuestions": [
      {
        "id": "tt_booker_email",
        "label": "Correo electrónico",
        "answer": "odin+booker@timetime.in"
      },
      {
        "id": "8f3e67b3-c381-4fb0-8197-dc53f73aa633",
        "label": "Nombre",
        "answer": "odinnn test"
      }
    ],
    "notes": "",
    "units": 1,
    "cancellation": null,
    "bookedResources": [],
    "conferenceLink": null,
    "privateNotes": [],
    "status": "CONFIRMED",
    "price": null,
    "confirmedAt": "2025-01-19T11:42:32.234713Z",
    "heldUntil": null
  },
  "old": null
}

{
  "type": "CalendarEventChanged",
  "new": {
    "id": "5934c6a5-6f01-4223-8b4d-308af18be8dc",
    "calendarId": "ae0e1585-a169-4e0a-bc8a-5a7a4ce7e62b",
    "interval": {
      "inclusiveStart": {
        "dateTime": "2024-03-20T15:00:00+01:00",
        "timeZone": "Europe/Madrid"
      },
      "exclusiveEnd": {
        "dateTime": "2024-03-20T16:00:00+01:00",
        "timeZone": "Europe/Madrid"
      }
    },
    "status": "CONFIRMED",
    "summary": "Some event",
    "description": "Some event description",
    "attachments": [],
    "locations": [],
    "attendees": [
      {
        "id": "460b4f91-87f8-4c03-8724-80a651e56976",
        "invitation": {
          "id": "27de4f27-46fb-4899-8ad4-bce8f3349afe",
          "displayTimeMode": "EXACT",
          "summary": "You have been invited to an event",
          "subtitle": "Please accept or decline the invitation.",
          "description": "Some invitation description"
        },
        "status": "ACCEPTED",
        "organizer": false,
        "email": "someone@example.com",
        "displayName": null,
        "comment": null,
        "managementUrl": "https://app.timetime.in/i/27de4f27-46fb-4899-8ad4-bce8f3349afc"
      }
    ],
    "comments": [
      "comment 1",
      "comment 2 🤣"
    ],
    "tags": {
      "tag 1": "grande"
    }
  },
  "semanticDiff": []
}