Skip to Content
Meeting Management API

Meeting Management API

The Meeting Management API lets you read the meetings (booking pages) configured in your TaskIP workspace and work with their bookings: list meetings, inspect a meeting and its booking form, list and inspect bookings, and create a booking for an available time slot.

Overview

The public API exposes:

  • Meetings: list meetings and fetch the full configuration of one meeting (host, availability, booking form, customisation)
  • Bookings: list the bookings of a meeting and fetch a single booking
  • Booking creation: book a time slot on a meeting

Meetings themselves are created and edited in the TaskIP application; this API does not create, update, or delete meetings or bookings other than creating a booking.

Main Endpoints Overview

MethodEndpointDescription
GET/api/public-v1/meeting-listGet all meetings
GET/api/public-v1/meeting/details/{uuid}Get meeting details
GET/api/public-v1/meeting/{uuid}/booking-listGet booking list for a meeting
GET/api/public-v1/meeting/{uuid}/booking/details/{id}Get specific booking details
POST/api/public-v1/meeting/{uuid}/bookingBook a meeting slot

Get All Meetings

Retrieve a list of all meetings in your system.

GET /api/public-v1/meeting-list

Request Headers

X-Secret-Key: your-secret-key-here Content-Type: application/json

Query Parameters

ParameterTypeRequiredDescription
pageintegerNoPage number for pagination (default: 1)
itemintegerNoMeetings per page (default: 10). Use 0 to return all meetings without pagination
searchstringNoSearch by meeting title

Results are ordered by id descending.

Example Request

curl -X GET "https://public-api.taskip.net/api/public-v1/meeting-list?page=1&item=20" \ -H "X-Secret-Key: your-secret-key-here" \ -H "Content-Type: application/json"

Example Response

{ "data": [ { "id": 1, "uuid": "9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77", "user_id": 12, "host": { "id": 12, "first_name": "Jane", "last_name": "Smith", "full_name": "Jane Smith", "email": "jane@taskip.com", "timezone": "America/New_York", "image": null }, "created_by": { "id": 12, "first_name": "Jane", "last_name": "Smith", "full_name": "Jane Smith", "email": "jane@taskip.com", "timezone": "America/New_York", "image": null }, "title": "Client Discovery Call", "description": "Initial discovery call with potential client", "duration": 60, "method": 2, "phone_option": null, "phone": null, "location": null, "status": 1, "slug": "client-discovery-call", "applicable_from": "2024-01-01T00:00:00.000000Z", "applicable_to": "2024-12-31T00:00:00.000000Z", "reminder": 1, "booking_status": 1, "timezone": "America/New_York", "booking_count": 3, "meeting_integration_id": null, "allow_guest": true, "repeat": false, "repeat_frequency": null, "repeat_until_type": null, "repeat_until_date": null, "logo": null } ], "links": { "first": "https://public-api.taskip.net/api/public-v1/meeting-list?page=1", "last": "https://public-api.taskip.net/api/public-v1/meeting-list?page=2", "prev": null, "next": "https://public-api.taskip.net/api/public-v1/meeting-list?page=2" }, "meta": { "current_page": 1, "from": 1, "last_page": 2, "path": "https://public-api.taskip.net/api/public-v1/meeting-list", "per_page": 10, "to": 10, "total": 25 } }

When search is supplied, meta.search echoes the search term. When item=0, the response contains only data.

Meeting Field Values

FieldValues
status0 = draft, 1 = published
method0 = in person, 1 = phone call, 2 = Google Meet, 3 = Zoom
phone_option0 = host will call, 1 = invitee will call (used with the phone call method)
booking_status0 = off, 1 = on
reminderinteger

Get Meeting Details

Retrieve detailed information about a specific meeting.

GET /api/public-v1/meeting/details/{uuid}

Path Parameters

ParameterTypeRequiredDescription
uuidstringYesMeeting UUID

Example Request

curl -X GET "https://public-api.taskip.net/api/public-v1/meeting/details/9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77" \ -H "X-Secret-Key: your-secret-key-here" \ -H "Content-Type: application/json"

Example Response

The meeting object is returned at the top level (not wrapped in data).

{ "id": 1, "uuid": "9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77", "user_id": 12, "host": { "id": 12, "first_name": "Jane", "last_name": "Smith", "full_name": "Jane Smith", "email": "jane@taskip.com", "timezone": "America/New_York", "image": null }, "allowed_team_members": [ { "id": 1, "first_name": "Mike", "last_name": "Wilson", "full_name": "Mike Wilson", "email": "mike@taskip.com", "timezone": "America/New_York", "image": null } ], "created_by": { "id": 12, "first_name": "Jane", "last_name": "Smith", "full_name": "Jane Smith", "email": "jane@taskip.com", "timezone": "America/New_York", "image": null }, "title": "Client Discovery Call", "description": "Initial discovery call with potential client to understand requirements", "duration": 60, "method": 2, "phone_option": null, "phone": null, "location": null, "status": 1, "slug": "client-discovery-call", "availability": [ { "id": 1, "meeting_uuid": "9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77", "day": 1, "status": 1, "times": [ { "id": 1, "meetings_day_id": 1, "time_slot_start": "09:00:00", "time_slot_end": "17:00:00", "utc_start": null, "utc_end": null } ] } ], "form": { "id": 1, "meeting_uuid": "9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77", "title": "Book a call", "description": null, "fields": [ { "id": "f_8a1b2c", "original_id": "email", "settings": { "condition": 0, "conditions": { "AND": null, "OR": null }, "fields": [ { "name": "email", "type": "email", "label": "Email", "required": true, "show": true } ], "filter": null } } ] }, "customise": { "meeting_uuid": "9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77", "button_text": "Book Meeting", "button_color": "#ffffff", "button_bg_color": "#2563eb", "button_hover_color": "#ffffff", "button_hover_bg_color": "#1d4ed8", "success_message": "Thank you for booking! We'll send you a confirmation email shortly.", "redirection": 0, "redirection_url": null, "description": null, "form_title": null, "default_timezone": null }, "booking_count": 3, "applicable_from": "2024-01-01T00:00:00.000000Z", "applicable_to": "2024-12-31T00:00:00.000000Z", "allow_guest": true, "meeting_integration_id": null, "repeat": false, "repeat_frequency": null, "repeat_until_type": null, "repeat_until_date": null, "logo": null }

availability[].day is 0 (Sunday) to 6 (Saturday) and availability[].status is 0 (unavailable) or 1 (available).

A meeting that does not exist returns 404 with {"status": 404, "msg": "Meeting not found"}.


Get Meeting Booking List

Retrieve all bookings for a specific meeting.

GET /api/public-v1/meeting/{uuid}/booking-list

Path Parameters

ParameterTypeRequiredDescription
uuidstringYesMeeting UUID

Query Parameters

ParameterTypeRequiredDescription
pageintegerNoPage number for pagination (default: 1)
itemintegerNoBookings per page (default: 10). Use 0 to return all bookings without pagination

Example Request

curl -X GET "https://public-api.taskip.net/api/public-v1/meeting/9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77/booking-list?page=1&item=20" \ -H "X-Secret-Key: your-secret-key-here" \ -H "Content-Type: application/json"

Example Response

{ "data": [ { "id": 1, "uuid": "b1c7e0aa-3f52-4a6e-8d11-0c9e5a7f2b34", "cancel_reason": null, "meeting": { "id": 1, "uuid": "9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77", "user_id": 12, "host": { "id": 12, "first_name": "Jane", "last_name": "Smith", "full_name": "Jane Smith", "email": "jane@taskip.com", "timezone": "America/New_York", "image": null }, "title": "Client Discovery Call", "duration": 60, "method": 2, "status": 1, "slug": "client-discovery-call", "timezone": "America/New_York", "allow_guest": true, "logo": null }, "first_name": "John", "last_name": "Doe", "email": "john.doe@client.com", "booking_data": [ { "id": "f_8a1b2c", "label": "Company", "value": "Acme Corporation" }, { "id": "f_3d4e5f", "label": "Meeting Purpose", "value": "Discuss website redesign requirements" } ], "date": "30-Jan-2024", "country": "United States", "ip": "192.168.1.1", "browser": "Chrome", "os": "MacOS", "device": "Desktop", "created_at": "26-Jan-2024", "time_slot_start": "2:00 PM", "time_slot_end": "3:00 PM", "meeting_link": "https://meet.google.com/xyz-abc-def", "meeting_provider": "Google Meet", "timezone": "America/New_York", "workspace_timezone": "America/New_York", "is_over": false, "status": 0 } ], "links": { "first": "https://public-api.taskip.net/api/public-v1/meeting/9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77/booking-list?page=1", "last": "https://public-api.taskip.net/api/public-v1/meeting/9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77/booking-list?page=1", "prev": null, "next": null }, "meta": { "current_page": 1, "from": 1, "last_page": 1, "path": "https://public-api.taskip.net/api/public-v1/meeting/9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77/booking-list", "per_page": 10, "to": 1, "total": 1 } }

The meeting object inside each booking is abbreviated here; it has the same fields as an item in Get All Meetings. date, created_at, time_slot_start and time_slot_end are formatted for display (d-M-Y and g:i A). status is an integer.

A meeting that does not exist returns 422 with {"error": {"msg": ["Meeting not found"]}}.


Get Booking Details

Retrieve detailed information about a specific booking.

GET /api/public-v1/meeting/{uuid}/booking/details/{id}

Path Parameters

ParameterTypeRequiredDescription
uuidstringYesMeeting UUID
idintegerYesBooking ID

Example Request

curl -X GET "https://public-api.taskip.net/api/public-v1/meeting/9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77/booking/details/1" \ -H "X-Secret-Key: your-secret-key-here" \ -H "Content-Type: application/json"

Example Response

{ "data": { "id": 1, "uuid": "b1c7e0aa-3f52-4a6e-8d11-0c9e5a7f2b34", "cancel_reason": null, "meeting": { "id": 1, "uuid": "9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77", "title": "Client Discovery Call", "duration": 60, "method": 2, "status": 1, "timezone": "America/New_York" }, "first_name": "John", "last_name": "Doe", "email": "john.doe@client.com", "booking_data": [ { "id": "f_8a1b2c", "label": "Company", "value": "Acme Corporation" } ], "date": "2024-01-30T00:00:00.000000Z", "country": "United States", "ip": "192.168.1.1", "browser": "Chrome", "os": "MacOS", "device": "Desktop", "created_at": "26-Jan-2024", "time_slot_start": "14:00:00", "time_slot_end": "15:00:00", "timezone": "America/New_York", "workspace_timezone": "America/New_York", "guest_email": ["guest@client.com"], "meeting_link": "https://meet.google.com/xyz-abc-def", "meeting_provider": "Google Meet", "status": 0 }, "availibility": [ { "id": 1, "meeting_uuid": "9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77", "day": 1, "status": 1, "times": [ { "id": 1, "meetings_day_id": 1, "time_slot_start": "09:00:00", "time_slot_end": "17:00:00", "utc_start": null, "utc_end": null } ] } ], "booking_data": { "f_8a1b2c____company": "Acme Corporation" } }

The top-level key is spelled availibility in the API response. The top-level booking_data is the raw submitted form data keyed by <field_id>____<field_name>, while data.booking_data is the rendered label/value list.

A meeting or booking that does not exist returns 422 with {"error": {"msg": ["Meeting not found"]}} or {"error": {"msg": ["Meeting booking not found"]}}.


Book a Meeting

Create a new booking for an available meeting slot. The booking form fields are validated against the meeting’s booking form (see form.fields in Get Meeting Details).

POST /api/public-v1/meeting/{uuid}/booking

Path Parameters

ParameterTypeRequiredDescription
uuidstringYesMeeting UUID

Request Body

FieldTypeRequiredDescription
datestringYesBooking date (YYYY-MM-DD), in the timezone given below
time_slot_startstringYesStart time (HH:MM)
time_slot_endstringYesEnd time (HH:MM)
booking_dataobjectYesBooking form answers, keyed by <field_id>____<field_name> for each field of the meeting’s booking form (for example f_8a1b2c____email). Field validation (required, email, number, …) follows the form configuration
guest_emailarrayNoArray of guest email addresses. May be omitted (treated as no guests) or sent as []
timezonestringNoTimezone of date / time_slot_* (defaults to the workspace timezone). Times are converted to the workspace timezone for storage

The first name, last name and email of the booker are read from the form’s name (..____first_name, ..____last_name) and email (..____email) fields.

Example Request

curl -X POST "https://public-api.taskip.net/api/public-v1/meeting/9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77/booking" \ -H "X-Secret-Key: your-secret-key-here" \ -H "Content-Type: application/json" \ -d '{ "date": "2024-02-15", "time_slot_start": "14:00", "time_slot_end": "15:00", "timezone": "America/New_York", "booking_data": { "f_name01____first_name": "John", "f_name01____last_name": "Doe", "f_8a1b2c____email": "john.doe@client.com" }, "guest_email": [] }'

Example Response

{ "success_msg": "Thank you for booking! We'll send you a confirmation email shortly.", "data": { "booking_id": 2, "booking_uuid": "c4d8a1f0-52b7-4e39-9a66-1f0b2d7e8c55", "meeting": { "uuid": "9f3a1c52-7d0e-4b1a-9c33-5d2b8e6f1a77", "user_id": 12, "title": "Client Discovery Call", "description": "Initial discovery call with potential client", "duration": 60, "method": 2, "phone_option": null, "phone": null, "location": null, "status": 1, "availability": [], "form": {}, "customise": {}, "applicable_from": "2024-01-01T00:00:00.000000Z", "applicable_to": "2024-12-31T00:00:00.000000Z", "timezone": "America/New_York", "allow_guest": true, "logo": null }, "user": { "first_name": "John", "last_name": "Doe", "email": "john.doe@client.com" }, "time_slot_start": "14:00:00", "time_slot_end": "15:00:00", "date": "2024-02-15T00:00:00.000000Z", "timezone": "America/New_York", "allow_guest": false } }

(The meeting object is abbreviated; it also contains host, created_by, availability, form and customise as in Get Meeting Details.)

Error Responses

StatusWhenBody
422date, time_slot_start, time_slot_end, or booking_data is missing{"error": {"date": ["The date field is required."]}}
422The meeting UUID does not exist{"error": {"msg": ["meeting not found"]}}
422The slot overlaps an existing booking{"error": {"msg": ["This time slot is already booked. Please select a different time."]}}
422booking_data fails the booking form’s validation{"error": {"<field_id>____<field_name>": ["..."]}, "status": 422}
403No price plan found for the workspace{"msg": "Price plan not found"}

📅

Meeting Integration: Meetings can use Google Meet or Zoom (method 2 and 3) for video conferencing and automatic meeting link generation.

⏰

Time Zones: Always send the timezone that date and time_slot_start / time_slot_end are expressed in. Times are converted to the workspace timezone before the booking is stored.

Last updated on