Skip to main content

Services / Event Types

An event-type is the fundamental concept of TimeTime. An event-type represents a service that can be booked.

For example, a hairdresser can have two types of events: "Haircut" and "Wash and blow dry". Each event-type will have its own particular availability rules, for example the duration of "haircut" will be 20m while "wash and blow dry" could be 40m.

An event-type can be created manually from the application or it can be created by making an HTTP request to our API passing. A detailed description of all the fields and options can be read in our API specification.

The following code snippet shows the required fields to create an event-type from our API:

fetch("https://api.timetime.in/v1/event-types/<event-type-uuid>", {
  method: "PUT",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer: <your-api-key>",
  },
  body: JSON.stringify({
    // Event duration is specified in ISO 8601 format
    "duration": "PT1H",
    // Service name
    "name": "Corte de pelo",
    // The slug is used to generate the URL of the booking page
    "slug": "corte-de-pelo",
    // The start frecuency of the service
    "step": "PT1H",
    // The UUID of the user that owns the service
    "userId": "<user-uuid>",
    // We can ignore those fields for now
    "questions": [],
    "thirdPartyCalendars": { "toSyncBookings": [], "toVerifyAvailability": [] },
    "busyIntervals": [],
  }),
});
  • <event-type-uuid>: Is an UUID of your choice to identify the event type.
    • If it already exists, the existing service will be modified and if it does not exist, a new one will be created.
    • You can use this autogenerated id to make tests:
  • <user-uuid>>: Is the universally unique identifier UUID of the user who owns the service.
  • <your-api-key>: Is the API key of the developer.

Each time a service is created, timetime generates a booking page where customers can check the availability.

The booking page url looks like this:

https://app.timetime.in/book/<event-type-uuid>.

The availability of a service can also be consulted from the API as we will see in the next section.