Skip to main content

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.

To facilitate integrations with third-party applications, TimeTime offers a series of webhooks that are triggered by certain events. These webhooks can be configured in the Webhooks section of your account settings.

Available webhooks​

TimeTime offers two types of webhooks:

  • Booking created: Triggered when a new booking is created.
  • Booking canceled: Triggered when a booking is canceled.
  • Booking updated: Triggered when a booking is updated.

Booking created​

This webhook is triggered when a new booking is created.

An example of the payload sent is the following. You can read the full specification of the fields in our API specs

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "eventType": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string"
  },
  "interval": {
    "start": "2023-02-10T09:27:07.759Z",
    "end": "2023-02-10T09:27:07.759Z"
  },
  "booker": {
    "email": "string"
  },
  "answeredQuestions": [
    {
      "id": "string",
      "label": "string",
      "answer": "string"
    }
  ],
  "notes": "string",
  "units": 0,
  "cancellation": {
    "cancelledBy": "ORGANIZER",
    "cancelledAt": "2023-02-10T09:27:07.759Z",
    "reason": "string"
  },
  "bookedResources": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string"
    }
  ]
}

Booking canceled​

This webhook is triggered when a booking is canceled.

An example of the payload sent is the following. You can read the full specification of the fields in our API specs

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "eventType": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string"
  },
  "interval": {
    "start": "2023-02-10T09:27:07.759Z",
    "end": "2023-02-10T09:27:07.759Z"
  },
  "booker": {
    "email": "string"
  },
  "answeredQuestions": [
    {
      "id": "string",
      "label": "string",
      "answer": "string"
    }
  ],
  "notes": "string",
  "units": 0,
  "cancellation": {
    "cancelledBy": "ORGANIZER",
    "cancelledAt": "2023-02-10T09:27:07.759Z",
    "reason": "string"
  },
  "bookedResources": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string"
    }
  ]
}

Booking updated​

This webhook is triggered when a booking is updated.

An example of the payload sent is the following. You can read the full specification of the fields in our API specs

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "eventType": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string"
  },
  "interval": {
    "start": "2023-02-10T09:27:07.759Z",
    "end": "2023-02-10T09:27:07.759Z"
  },
  "booker": {
    "email": "string"
  },
  "answeredQuestions": [
    {
      "id": "string",
      "label": "string",
      "answer": "string"
    }
  ],
  "notes": "string",
  "units": 0,
  "cancellation": {
    "cancelledBy": "ORGANIZER",
    "cancelledAt": "2023-02-10T09:27:07.759Z",
    "reason": "string"
  },
  "bookedResources": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string"
    }
  ]
}