Autorizzazione
Your request should contain the header: 'X-API-KEY'.
Note: This is a Paid plan feature.
API key will become automatically available on your Integrations page as soon as you upgrade.
Base url
https://secure.simplymeet.me
Esempio di richiesta HTTP:
POST https://secure.simplymeet.me/panel/api/event/cancel/123
Content-Type: application/json
X-API-KEY: <insert your X-API-KEY here>
{
"reason": "<insert your reason here>",
}
Metodi
-
Get list of ACL rules
Returns list of ACL rulesTermine:
/panel/api/aclMetodo:
getTorna:
-
Save availability rule
Saves the availability ruleTermine:
/panel/api/availability-ruleMetodo:
putRichiedi Parametri:
AvailabilityRuleRequestDTO body - Availability rule dataTorna:
Returns empty response when the operation is successful -
Get organization cancellation policy
Returns the cancellation policy of the organizationTermine:
/panel/api/organization-cancellation-policyMetodo:
getTorna:
-
Update organization cancellation policy
Updates the cancellation policy of the organizationTermine:
/panel/api/organization-cancellation-policyMetodo:
putRichiedi Parametri:
CancellationPolicyRequestDTO body - Cancellation policy dataTorna:
-
Get user cancellation policy
Returns the cancellation policy of the userTermine:
/panel/api/user-cancellation-policyMetodo:
getTorna:
-
Update user cancellation policy
Updates the cancellation policy of the userTermine:
/panel/api/user-cancellation-policyMetodo:
putRichiedi Parametri:
CancellationPolicyRequestDTO body - Cancellation policy dataTorna:
-
Delete event list
Delete event list by idsTermine:
/panel/api/event/delete-listMetodo:
deleteRichiedi Parametri:
DeleteEventListRequestDTO body - An array of integers representing the IDs of the events to be deletedTorna:
Returns empty response when the operation is successful -
Cancel event list
Cancel event list by idsTermine:
/panel/api/event/cancel-listMetodo:
putRichiedi Parametri:
CancelEventListRequestDTO body - An object containing an array of event IDs to be cancelled and an optional reason for the cancellationTorna:
Returns empty response when the operation is successful -
Create event
Create event by request paramsTermine:
/panel/api/eventMetodo:
postRichiedi Parametri:
CreateEventRequestDTO body - An object containing the event detailsTorna:
-
Get event
Get event by idTermine:
/panel/api/event/{id}Metodo:
getRichiedi Parametri:
int id - The id of the eventTorna:
-
Edit event
Edit event by request params and IDTermine:
/panel/api/event/{id}Metodo:
putRichiedi Parametri:
int id - The id of the eventEditEventRequestDTO body - An object containing the event detailsTorna:
void -
Delete event
Delete event by idTermine:
/panel/api/event/{id}Metodo:
deleteRichiedi Parametri:
int id - The id of the eventTorna:
Returns empty response when the operation is successful -
Cancel event
Cancel event by idTermine:
/panel/api/event/cancel/{id}Metodo:
putRichiedi Parametri:
int id - The id of the eventCancelEventRequestDTO body - An object containing the reason for the cancellationTorna:
Returns empty response when the operation is successful -
Edit event notes
Edit event notes by idTermine:
/panel/api/event/notes/{id}Metodo:
putRichiedi Parametri:
int id - The id of the eventEventEditNotesRequestDTO body - An object containing the notes for the eventTorna:
Returns empty response when the operation is successful -
Get list of events
Get list of events by request paramsTermine:
/panel/api/event/Metodo:
getRichiedi Parametri:
GetEventListRequestDTO query - An object containing the request parameters for fetching the list of eventsTorna:
{meta: MetaDataDTOitems: EventDTO[]} -
No show event
No show event by idTermine:
/panel/api/event/no-show/{id}Metodo:
putRichiedi Parametri:
int id - The id of the eventTorna:
Returns empty response when the operation is successful -
No show event list
No show event list by idsTermine:
/panel/api/event/no-show-listMetodo:
putRichiedi Parametri:
NoShowEventListRequestDTO body - An object containing an array of event IDs to be no-showedTorna:
Returns empty response when the operation is successful -
Resend event notification
Resend event notification by idTermine:
/panel/api/event/resend-notification/{id}Metodo:
putRichiedi Parametri:
int id - The id of the eventTorna:
Returns empty response when the operation is successful -
Invite participants to event
Invite participants to event by idTermine:
/panel/api/event/invite-participants/{id}Metodo:
postRichiedi Parametri:
int id - The id of the eventEventInviteParticipantsRequestDTO body - An object containing an array of participant emails and an optional message for the invitationTorna:
Returns empty response when the operation is successful -
Reschedule event
Reschedule event by idTermine:
/panel/api/event/reschedule/{id}Metodo:
putRichiedi Parametri:
int id - The id of the eventRescheduleEventRequestDTO body - An object containing the new date and time for the event, the event type ID, and an optional user IDTorna:
Returns empty response when the operation is successful -
Get list of event types
Get list of event types by request paramsTermine:
/panel/api/event-typeMetodo:
getRichiedi Parametri:
GetEventTypeListRequestDTO query - An object containing the request parameters for fetching the list of event typesTorna:
-
Get event type availability
Get event type availability by request paramsTermine:
/panel/api/event-type/availability/{id}Metodo:
getRichiedi Parametri:
int id - The id of the event typeGetEventTypeAvailabilityRequestDTO query - An object containing the request parameters for fetching the availability of the event typeTorna:
-
Get event type
Get event type by idTermine:
/panel/api/event-type/{id}Metodo:
getRichiedi Parametri:
int id - The id of the event typeTorna:
-
Add event type tag to event type
Add event type tag to event type descriptionTermine:
/panel/api/event-type-tag/{eventTypeId}/{tagId}Metodo:
putRichiedi Parametri:
int eventTypeId - The id of the event typeint tagId - The id of the tagTorna:
Returns empty response when the operation is successful -
Remove event type tag
Remove event type tag by event type id and tag idTermine:
/panel/api/event-type-tag/{eventTypeId}/{tagId}Metodo:
deleteRichiedi Parametri:
int eventTypeId - The id of the event typeint tagId - The id of the tagTorna:
Returns empty response when the operation is successful -
Get event type tag list
Get event type tag list by event type idTermine:
/panel/api/event-type-tag/{eventTypeId}Metodo:
getRichiedi Parametri:
int eventTypeId - The id of the event typeTorna:
-
Get list of integrations
Returns list of integrationsTermine:
/panel/api/integrationMetodo:
getTorna:
-
Retrieve a poll by ID
Retrieves a poll based on the provided IDTermine:
/panel/api/poll/{id}Metodo:
getRichiedi Parametri:
int id - ID of the pollTorna:
-
Delete a poll
Delete a poll by IDTermine:
/panel/api/poll/{id}Metodo:
deleteRichiedi Parametri:
int id - ID of the pollTorna:
Returns empty response when the operation is successful -
Create a poll result
Create a poll result with the provided request dataTermine:
/panel/api/poll/poll-resultMetodo:
postRichiedi Parametri:
PollResultRequestDTO body - The request data for creating a poll resultTorna:
Returns empty response when the operation is successful -
Create a new poll
Create a new poll with the provided request dataTermine:
/panel/api/pollMetodo:
postRichiedi Parametri:
PollRequestDTO body - The request data for creating a new pollTorna:
-
Get list of polls
Get list of polls by request paramsTermine:
/panel/api/pollMetodo:
getRichiedi Parametri:
GetPollListRequestDTO request - The request parameters for fetching the list of pollsTorna:
PollDTO[] -
Create a single use link
Create a single use link for an event typeTermine:
/panel/api/single-use-link/{id}Metodo:
postRichiedi Parametri:
int id - ID of the event typeTorna:
-
Get current user
Returns the current userTermine:
/panel/api/current-userMetodo:
getTorna:
-
Get user list
Returns the list of usersTermine:
/panel/api/userMetodo:
getTorna:
UserDTO[] -
Get user event type tag list
Returns the list of user event type tagsTermine:
/panel/api/user-event-type-tagMetodo:
getTorna:
UserEventTypeTagDTO[] -
Create user event type tag
Creates a new user event type tagTermine:
/panel/api/user-event-type-tagMetodo:
postRichiedi Parametri:
UserEventTypeTagRequestDTO body - User event type tag dataTorna:
UserEventTypeTagDTO -
Update user event type tag
Updates the specified user event type tagTermine:
/panel/api/user-event-type-tag/{id}Metodo:
putRichiedi Parametri:
int id - The ID of the user event type tag to updateUserEventTypeTagRequestDTO body - User event type tag dataTorna:
UserEventTypeTagDTO -
Delete user event type tag
Deletes the specified user event type tagTermine:
/panel/api/user-event-type-tag/{id}Metodo:
deleteRichiedi Parametri:
int id - The ID of the user event type tag to deleteTorna:
Successful operation
Acl
Regola di disponibilità
Politica di cancellazione
Riunione
Tipo di riunione
Tag del tipo di riunione
Integrazione
Sondaggio
Collegamento monouso
Utente
Tag del tipo di riunione dell'utente
-
AclRuleDTO
Access Control List Rule schemaNome Type Descrizione resource string Resource name attributes array Resource attributes allowedAttributes array Allowed attributes for current user -
AnswerDTO
AnswerNome Type Descrizione id int The unique identifier of the answer. questionLabel string The label of the question. questionType string The type of the question. value string The value of the answer. plainValue string The plain value of the answer. questionUuid string questionUuid -
AnswerRequestDTO
Answer request schemaNome Type Descrizione value string Answer value question string Question UUID -
AvailabilityRuleDTO
Availability RuleNome Type Descrizione type string The type of the availability rule. hourIntervals HourIntervalDTO[] The hour intervals of the availability rule. config object The configuration of the availability rule. Example: {date: '2023-11-16'} or {weekday: 'wednesday'} -
AvailabilityRuleRequestDTO
Availability Rule RequestNome Type Descrizione eventTypeIds array The event type IDs. availabilityRules AvailabilityRuleDTO[] The availability rules. periodType string The type of the period. periodTypeConfig object The configuration of the period type. Example: {start: '2022-01-01', end: '2022-12-31'} availabilityType string Save only for weekday or date availability type. If not set, it will be saved for both types -
CancelEventListRequestDTO
Cancel event list request schemaNome Type Descrizione ids array Event ids reason string Reason of cancellation. -
CancelEventRequestDTO
Cancel event request schemaNome Type Descrizione reason string Reason of cancellation. -
CancellationDTO
CancellationNome Type Descrizione id int The unique identifier of the cancellation. canceler string The user of the cancellation. reason string The reason of the cancellation. -
CancellationPolicyDTO
Cancellation policy data transfer objectNome Type Descrizione enabled bool Enabled status period int Cancellation policy period in minutes label string Cancellation policy label text string Cancellation policy text version int Version type string Type of the cancellation policy. Can be 'user' or 'organization' overwrite_personal bool Overwrite personal cancellation policy -
CancellationPolicyRequestDTO
Cancellation policy request DTONome Type Descrizione enabled bool Enabled status period int Cancellation policy period in minutes label string Cancellation policy label text string Cancellation policy text overwritePersonal bool Overwrite personal cancellation policy -
CreateEventRequestDTO
Create event request schemaNome Type Descrizione scheduledAt string Start date and time. Format: Y-m-d H:i:s multipleScheduledAt array Array of start dates and times. eventType int Event type id assigned to event. invitee InviteeRequestDTO Invitee data durationId int Duration id answers AnswerRequestDTO[] Answers participants ParticipantRequestDTO[] Participants locationType string Location type location string Location -
DeleteEventListRequestDTO
Delete event list request schemaNome Type Descrizione ids array Event ids -
EditEventAnswerRequestDTO
EditEventAnswerRequestDTONome Type Descrizione id int Answer id. value string Answer value -
EditEventInviteeRequestDTO
EditEventInviteeRequestDTONome Type Descrizione fullName string The full name of the invitee. phoneNumber string The phone number of the invitee. -
EditEventRequestDTO
EditEventRequestDTONome Type Descrizione id int Event id. Ignore this field. invitee InviteeRequestDTO">EditEventInviteeRequestDTO Invitee data answers EditEventAnswerRequestDTO[] Answers -
EventDTO
Event DTONome Type Descrizione id int Event ID uuid string Event UUID user UserDTO User DTO object (event owner) eventType EventTypeDTO Event type DTO object invitee InviteeDTO Invitee DTO object cancellation CancellationDTO Cancellation DTO object participants ParticipantDTO[] Array of Participant DTO objects answers AnswerDTO[] Array of Answer DTO objects rescheduling ReschedulingDTO[] Array of Rescheduling DTO objects payment EventPaymentDTO Event payment DTO object createdAt string The date and time when the event was created. updatedAt string The date and time when the event was last updated. scheduledAt string The date and time when the event was scheduled. endDate string The date and time when the event was ended. canceledAt string The date and time when the event was canceled. state string Event state notes string Event notes details string Event details location string Event location locationType string Event location type onlineEventId string Online event ID sentEmailReminder int Sent email reminder lastSentInviteeEmailReminder int Last sent invitee email reminder lastSentInviteeEmailFollowUp int Last sent invitee email follow up duration int Event duration users UserDTO[] Array of UserDTO objects assigned to the event relatedEventIds array Array of related event IDs -
EventEditNotesRequestDTO
Event edit notes request schemaNome Type Descrizione notes string Notes. -
EventInviteParticipantsRequestDTO
Event invite participants request schemaNome Type Descrizione emails array Emails message string Message -
EventPaymentDTO
EventPaymentDTONome Type Descrizione provider string provider amount number amount currency string currency status string status system string system referenceId int referenceId overwritePersonal bool overwritePersonal -
EventTypeAvailabilityDTO
Event Type AvailabilityNome Type Descrizione date string The date of the availability hours EventTypeAvailabilityHoursDTO[] Array of availability hours available bool Indicates if the date is available -
EventTypeAvailabilityHoursDTO
Event Type Availability HoursNome Type Descrizione start string The start time of the availability hour available bool Indicates if the hour is available -
EventTypeDTO
Event type DTONome Type Descrizione id int Unique identifier for the event type name string Name of the event type color string Color user UserDTO User DTO object (event type owner) type string Type: regular, round-robin, collective duration int Duration in minutes slug string Slug (unique identifier for the event type) amount number Amount currency string Currency locationType string Location type: 'custom', 'zoom', 'request', 'whereby', 'google_meet', 'kopano_meet', 'microsoft_teams' location string Event location - custom text isEnabled bool Flag to indicate if the event type is enabled isSecret bool Flag to indicate if the event type is secret users UserDTO[] Array of UserDTO objects assigned to the event type timezone string Timezone isLocalized bool Flag to indicate if the event type show booking page in client timezone durationType string Duration type: fixed or flexible eventTypeDurations EventTypeDurationDTO[] Flexible durations position int Position eventTypeRequestLocationTypes EventTypeRequestLocationTypeDTO[] Request location types uuid string UUID attribute isAllowCancel bool Display cancellation link in notifications isAllowReschedule bool Display reschedule link in notifications isShowPhone bool Flag to indicate if phone is to be shown isPhoneFieldRequired bool Flag to indicate if phone field is required questions QuestionDTO[] Event type questions isMultipleMeeting bool Flag to indicate if multiple events are allowed (Allow clients to book multiple event slots) locationLabel string Location question if location type = request groupMeetingLimit int Group meeting limit showGroupMeetingRest bool Show group meeting rest -
EventTypeDurationDTO
EventTypeDurationDTONome Type Descrizione id int The unique identifier of the duration. duration int Duration in minutes -
EventTypeRequestLocationTypeDTO
EventTypeRequestLocationTypeDTONome Type Descrizione id int The unique identifier locationType string Location type: 'custom', 'zoom', 'request', 'whereby', 'google_meet', 'kopano_meet', 'microsoft_teams' -
EventTypeTagDTO
Event Type TagNome Type Descrizione id int The id of the event type tag name string The name of the event type tag color string The color of the event type tag position int The position of the event type tag enabled bool Indicates if the event type tag is enabled -
GetEventListFilterDTO
Get Event List FilterNome Type Descrizione ids array Event ids eventTypeType string Event type type state string Event state paymentStatus string Payment status invitee string Invitee (email or name) uuid string Event uuid eventTypeList array Event type ids userList array User ids organizationTagList array Organization tag ids scheduledAtFrom string Scheduled at from: YYYY-MM-DD scheduledAtTo string Scheduled at to: YYYY-MM-DD -
GetEventListRequestDTO
Get Event List RequestNome Type Descrizione page int Page number for pagination. Should be greater than 0. onPage int Number of items per page. Should be greater than 0 and less than or equal to 100. orderField string Field to use for sorting. orderDirection string Sort direction. Should be either 'asc' (ascending) or 'desc' (descending). skipPagination bool Flag to skip pagination. groupBy string Field to use for grouping. GetEventListFilterDTO GetEventListFilterDTO Filter for getting event list -
GetEventTypeAvailabilityRequestDTO
Get Event Type Availability RequestNome Type Descrizione id int The id of the event type startDate string The start date of the availability endDate string The end date of the availability timezone string The timezone of the availability durationId int The id of the duration userId int The id of the user -
GetEventTypeListFilterDTO
Get Event Type List FilterNome Type Descrizione ids array Event type ids forCurrentUser bool Get event types for current user manageRoundRobin bool To retrieve a list of event types that a user can edit. type string Event type type -
GetEventTypeListRequestDTO
Get Event Type List RequestNome Type Descrizione page int Page number for pagination. Should be greater than 0. onPage int Number of items per page. Should be greater than 0 and less than or equal to 100. orderField string Field to use for sorting. orderDirection string Sort direction. Should be either 'asc' (ascending) or 'desc' (descending). skipPagination bool Flag to skip pagination. groupBy string Field to use for grouping. filter GetEventTypeListFilterDTO Filter for getting event type list -
GetPollListRequestDTO
GetPollListRequestDTONome Type Descrizione page int Page number for pagination. Should be greater than 0. onPage int Number of items per page. Should be greater than 0 and less than or equal to 100. orderField string Field to use for sorting. orderDirection string Sort direction. Should be either 'asc' (ascending) or 'desc' (descending). skipPagination bool Flag to skip pagination. groupBy string Field to use for grouping. -
HourIntervalDTO
Hour IntervalNome Type Descrizione start string The start time of the interval. end string The end time of the interval. -
IntegrationListDTO
Integration list data transfer objectNome Type Descrizione user array User integrations organization array Organization integrations -
InviteeDTO
InviteeNome Type Descrizione id int The unique identifier of the invitee. email string The email address of the invitee. fullName string The full name of the invitee. timezone string The timezone of the invitee. phoneNumber string The phone number of the invitee. locale string The locale of the invitee. cancellationPolicy string The cancellation policy of the invitee. uuid string The UUID of the invitee -
InviteeRequestDTO
Invitee request schemaNome Type Descrizione fullName string Full name email string Email timezone string Timezone locale string Locale phoneNumber string Phone number cancellationPolicy string Cancellation policy -
MetaDataDTO
Metadata for the paginated resultNome Type Descrizione pagesCount int The total number of pages itemsPerPage int The number of items per page itemsCount int The total number of items currentPage int The current page -
NoShowEventListRequestDTO
No show event list request schemaNome Type Descrizione ids array Event ids -
OrganizationDTO
OrganizationDTONome Type Descrizione id int The unique identifier of the organization. uuid string The unique UUID identifier of the organization. slug string Slug (unique identifier for the organization) name string The name of the organization. createdAt string The date and time when the organization was created. locale string The locale of the organization. rtl bool The right-to-left layout of the organization. calendarLayout string The calendar layout of the organization. hideUnavailableDates bool Hide unavailable dates. sundayIsFirstDay bool Sunday is the first day of the week. email string The email associated with the organization. intro string The intro associated with the organization. domain string The custom domain associated with the organization. socialLink SocialLinkDTO The social links associated with the organization. -
ParticipantDTO
ParticipantNome Type Descrizione id int The unique identifier of the participant. email string The email address of the participant. createdAt string The creation date of the participant. -
ParticipantRequestDTO
Participant request schemaNome Type Descrizione email string Email -
PollAvailabilityDTO
Data Transfer Object (DTO) for Poll AvailabilityNome Type Descrizione id int Poll ID date string Poll date in ISO 8601 format (e.g., 2023-12-31T23:59:59+00:00) results PollResultDTO[] Poll results -
PollAvailabilityRequestDTO
Poll availability request schemaNome Type Descrizione date string The date for checking poll availability -
PollDTO
Data Transfer Object (DTO) for PollNome Type Descrizione id int Poll ID uuid string Poll UUID user user user eventType eventType eventType voteVisibility bool Visibility of the poll vote commentVisibility bool Visibility of the poll comment emailNotification bool Email notification for the poll duration int Duration of the poll in minutes name string Name of the poll createdAt string Creation date of the poll in ISO 8601 format availability PollAvailabilityDTO">PollAvailabilityDTO[] Array of availability slots for the poll -
PollRequestDTO
Poll request schemaNome Type Descrizione eventTypeId int Event type ID for the poll voteVisibility bool Visibility of the poll vote commentVisibility bool Visibility of the poll comment emailNotification bool Email notification for the poll duration int Duration of the poll in minutes name string Name of the poll availability PollAvailabilityRequestDTO[] Array of availability slots for the poll -
PollAvailabilityDTO
Data Transfer Object (DTO) for Poll ResultNome Type Descrizione email string Email address of the client comment string Comment of the client -
PollResultRequestDTO
Poll result request schemaNome Type Descrizione uuid string Poll UUID availability array Availability ids email string email comment string comment -
QuestionDTO
QuestionDTONome Type Descrizione label string The label of the question. type string The type of the question. required bool Determines if the question is required or not. config array Question config. [{label: 'value'}, {label: 'value'}] uuid string The unique identifier of the question. position int The position/order of the question. -
RescheduleEventRequestDTO
Reschedule event request schemaNome Type Descrizione start string Start date and time. Format: Y-m-d H:i:s end string End date and time. Format: Y-m-d H:i:s eventTypeId int Event type id assigned to event. userId int User id assigned to event. -
ReschedulingDTO
ReschedulingNome Type Descrizione id int The unique identifier of the rescheduling. rescheduler string The user of the rescheduling. reason string The reason of the rescheduling. previouslyScheduledAt string The date and time of the rescheduling. previousUser UserDTO The user of the previous appointment. -
SimpleEventTypeDTO
SimpleEventTypeDTONome Type Descrizione id int id slug string slug name string name color string color location_type string location_type timezone string timezone user_full_name string user_full_name localized bool localized direct_url string direct_url -
SimpleUserDTO
SimpleUserDTONome Type Descrizione id int id email string email fullName string fullName -
SingleUseLinkDTO
Single use link response schemaNome Type Descrizione code string The code of the single use link url string The URL of the single use link -
SocialLinkDTO
SocialLinkDTONome Type Descrizione id int The unique identifier of the social link. facebookUrl string The URL of the Facebook profile. twitterUrl string The URL of the Twitter profile. instagramUrl string The URL of the Instagram profile. linkedinUrl string The URL of the LinkedIn profile. whatsappUrl string The URL of the WhatsApp profile. -
UserDTO
UserNome Type Descrizione id int The unique identifier of the user. uuid string The UUID of the user email string The email address of the user. fullName string The full name of the user. slug string Slug (unique identifier for the user) subscriptionUsersLimit int The limit of users that can be added to the subscription. isSecondFactorConfigured bool Determines if the second factor authentication is configured for the user. isEnabled bool Determines if the user account is enabled or not. dateFormat string The date format of the user. address string The address of the user. state string The state of the user's address. city string The city of the user's address. zip string The zip code of the user's address. countryId string The country ID of the user's address. lat number The latitude coordinate of the user's location. lng number The longitude coordinate of the user's location. domain string The custom domain associated with the user. phone string The phone number associated with the user. companyLogoName string The name of the company logo associated with the user. avatarName string The name of the avatar associated with the user. organization OrganizationDTO The organization details associated with the user. createdAt string The date and time when the user was created. lastLogin string The date and time of the user's last login. connections array List of OAuth connections hasPaidSubscription bool Determines if the user has a paid subscription. timezone string timezone timeFormat string timeFormat timezoneOffset string timezoneOffset -
UserEventTypeTagDTO
User Event Type TagNome Type Descrizione id int The unique identifier of the event type tag. name string The name of the event type tag. color string The color of the event type tag. position int The position of the event type tag. user UserDTO The user associated with the event type tag. -
UserEventTypeTagRequestDTO
User Event Type Tag RequestNome Type Descrizione position int The position of the event type tag. name string The name of the event type tag. color string The color of the event type tag.