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
| Method | Endpoint | Description |
|---|---|---|
GET | /api/public-v1/meeting-list | Get all meetings |
GET | /api/public-v1/meeting/details/{uuid} | Get meeting details |
GET | /api/public-v1/meeting/{uuid}/booking-list | Get booking list for a meeting |
GET | /api/public-v1/meeting/{uuid}/booking/details/{id} | Get specific booking details |
POST | /api/public-v1/meeting/{uuid}/booking | Book a meeting slot |
Get All Meetings
Retrieve a list of all meetings in your system.
GET /api/public-v1/meeting-listRequest Headers
X-Secret-Key: your-secret-key-here
Content-Type: application/jsonQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page | integer | No | Page number for pagination (default: 1) |
item | integer | No | Meetings per page (default: 10). Use 0 to return all meetings without pagination |
search | string | No | Search 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
| Field | Values |
|---|---|
status | 0 = draft, 1 = published |
method | 0 = in person, 1 = phone call, 2 = Google Meet, 3 = Zoom |
phone_option | 0 = host will call, 1 = invitee will call (used with the phone call method) |
booking_status | 0 = off, 1 = on |
reminder | integer |
Get Meeting Details
Retrieve detailed information about a specific meeting.
GET /api/public-v1/meeting/details/{uuid}Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
uuid | string | Yes | Meeting 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-listPath Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
uuid | string | Yes | Meeting UUID |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page | integer | No | Page number for pagination (default: 1) |
item | integer | No | Bookings 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
| Parameter | Type | Required | Description |
|---|---|---|---|
uuid | string | Yes | Meeting UUID |
id | integer | Yes | Booking 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}/bookingPath Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
uuid | string | Yes | Meeting UUID |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
date | string | Yes | Booking date (YYYY-MM-DD), in the timezone given below |
time_slot_start | string | Yes | Start time (HH:MM) |
time_slot_end | string | Yes | End time (HH:MM) |
booking_data | object | Yes | Booking 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_email | array | No | Array of guest email addresses. May be omitted (treated as no guests) or sent as [] |
timezone | string | No | Timezone 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
| Status | When | Body |
|---|---|---|
422 | date, time_slot_start, time_slot_end, or booking_data is missing | {"error": {"date": ["The date field is required."]}} |
422 | The meeting UUID does not exist | {"error": {"msg": ["meeting not found"]}} |
422 | The slot overlaps an existing booking | {"error": {"msg": ["This time slot is already booked. Please select a different time."]}} |
422 | booking_data fails the booking form’s validation | {"error": {"<field_id>____<field_name>": ["..."]}, "status": 422} |
403 | No 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.