---
canonical_url: "https://docs.composio.dev/toolkits/go_table"
markdown_url: "https://docs.composio.dev/toolkits/go_table.md"
product: "platform"
version: null
last_updated: null
---

# GoTable

GoTable provides restaurant reservation, guest, offer, table, availability, and webhook management through its REST API.

- **Category:** scheduling & booking
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 19
- **Triggers:** 0
- **Slug:** `GO_TABLE`
- **Version:** 00000000_00

## Tools

### Cancel Reservation

**Slug:** `GO_TABLE_CANCEL_RESERVATION`

Irreversibly cancel a finalized reservation or reject a pending reservation. The selected role controls GoTable's default communication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role` | string ("restaurant" | "guest") | No | Cancellation perspective. restaurant sends GoTable's default communication to the guest; guest sends it to the restaurant. |
| `restaurant_id` | integer | Yes | ID of the restaurant that owns the reservation. |
| `reservation_id` | integer | Yes | ID of the reservation to cancel or reject. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Reservation

**Slug:** `GO_TABLE_CREATE_RESERVATION`

Create a reservation or walk-in. Guest-role calls enforce availability and may trigger guest-facing operational communication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Reservation date in YYYY-MM-DD format; required for a Reservation. |
| `role` | string ("restaurant" | "guest") | No | Creation role. restaurant bypasses most availability checks; guest applies guest validation and availability checks. |
| `time` | string | No | Reservation time in HH:MM format; required for a Reservation. |
| `type` | string ("Reservation" | "WalkIn") | No | Create a scheduled Reservation or a WalkIn. A WalkIn may default omitted date and time to the current time. |
| `comments` | string | No | Comments visible on the reservation. |
| `offer_id` | integer | No | Offer ID to associate with the reservation. |
| `table_ids` | array | No | Restaurant table IDs to assign; ignored when role is guest. |
| `guest_name` | string | No | Guest's name. |
| `party_size` | integer | Yes | Number of guests in the party. |
| `table_lock` | boolean | No | Whether assigned tables should be locked; ignored when role is guest. |
| `guest_email` | string | No | Guest's email address. Provide it only with consent; creating the reservation may trigger guest-facing communication. |
| `restaurant_id` | integer | Yes | ID of the restaurant where the reservation or walk-in will be created. |
| `guest_telephone` | string | No | Guest's telephone number. |
| `duration_in_minutes` | integer | No | Requested reservation duration in minutes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Reservation Note

**Slug:** `GO_TABLE_CREATE_RESERVATION_NOTE`

Attach an HTML note to a reservation under an account that has access to the restaurant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `content` | string | Yes | HTML content of the note. |
| `author_id` | integer | Yes | ID of an account with access to the restaurant. Obtain it from List Restaurant Accounts. |
| `restaurant_id` | integer | Yes | ID of the restaurant that owns the reservation. |
| `reservation_id` | integer | Yes | ID of the reservation that will receive the note. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Availability

**Slug:** `GO_TABLE_GET_AVAILABILITY`

Return restaurant-wide availability, or availability for one offer when offer_id is provided, over a date range of at most three months.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `offer_id` | integer | No | Offer ID for offer-specific availability; omit for restaurant-wide availability. |
| `from_date` | string | No | First date to include in YYYY-MM-DD format. |
| `till_date` | string | No | Last date to include in YYYY-MM-DD format, no more than three months after from_date. |
| `restaurant_id` | integer | Yes | ID of the restaurant whose availability to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Guest

**Slug:** `GO_TABLE_GET_GUEST`

Return one guest profile by restaurant and guest ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guest_id` | integer | Yes | ID of the guest to retrieve. |
| `restaurant_id` | integer | Yes | ID of the restaurant that owns the guest profile. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Offer

**Slug:** `GO_TABLE_GET_OFFER`

Return one booking offer by restaurant and offer ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `offer_id` | integer | Yes | ID of the offer to retrieve. |
| `restaurant_id` | integer | Yes | ID of the restaurant that owns the offer. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Reservation

**Slug:** `GO_TABLE_GET_RESERVATION`

Return one reservation by restaurant and reservation ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `restaurant_id` | integer | Yes | ID of the restaurant that owns the reservation. |
| `reservation_id` | integer | Yes | ID of the reservation to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Restaurant

**Slug:** `GO_TABLE_GET_RESTAURANT`

Return details for one accessible restaurant by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `restaurant_id` | integer | Yes | ID of the restaurant to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Table

**Slug:** `GO_TABLE_GET_TABLE`

Return one physical table by restaurant and table ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `table_id` | integer | Yes | ID of the table to retrieve. |
| `restaurant_id` | integer | Yes | ID of the restaurant that owns the table. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Table Combination

**Slug:** `GO_TABLE_GET_TABLE_COMBINATION`

Return one configured table combination by restaurant and combination ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `restaurant_id` | integer | Yes | ID of the restaurant that owns the table combination. |
| `combination_id` | integer | Yes | ID of the table combination to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Restaurant Accounts

**Slug:** `GO_TABLE_LIST_ACCOUNTS`

Return one page of user accounts that can access a restaurant, including IDs usable as reservation-note authors.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `per_page` | integer | No | Maximum accounts to return on this page (1-100). |
| `restaurant_id` | integer | Yes | ID of the restaurant whose accounts to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Guests

**Slug:** `GO_TABLE_LIST_GUESTS`

Return one page of restaurant guests, optionally filtered with GoTable's guest search syntax.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Fuzzy text and filters such as 'John last_visit>=2026-08-23'. Supported fields include name, email, telephone, last_visit, visits, and reservations. |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `per_page` | integer | No | Maximum guests to return on this page (1-100). |
| `restaurant_id` | integer | Yes | ID of the restaurant whose guests to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Offers

**Slug:** `GO_TABLE_LIST_OFFERS`

Return one page of booking offers configured for a restaurant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `per_page` | integer | No | Maximum offers to return on this page (1-100). |
| `restaurant_id` | integer | Yes | ID of the restaurant whose offers to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Reservation Notes

**Slug:** `GO_TABLE_LIST_RESERVATION_NOTES`

Return all notes attached to one reservation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `restaurant_id` | integer | Yes | ID of the restaurant that owns the reservation. |
| `reservation_id` | integer | Yes | ID of the reservation whose notes to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Reservations

**Slug:** `GO_TABLE_LIST_RESERVATIONS`

Return one page of reservations for a restaurant, optionally filtered with GoTable's reservation search syntax.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Fuzzy text and filters such as 'John date>=2026-08-23 state=confirmed party_size=2'. Supported fields include type, offer_id, date, time, state, party_size, guest contact, comments, and duration_in_minutes. |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `per_page` | integer | No | Maximum reservations to return on this page (1-100). |
| `restaurant_id` | integer | Yes | ID of the restaurant whose reservations to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Restaurants

**Slug:** `GO_TABLE_LIST_RESTAURANTS`

Return one page of restaurants accessible to the connected GoTable account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `per_page` | integer | No | Maximum restaurants to return on this page (1-100). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Table Combinations

**Slug:** `GO_TABLE_LIST_TABLE_COMBINATIONS`

Return one page of configured table combinations for a restaurant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `per_page` | integer | No | Maximum combinations to return on this page (1-100). |
| `restaurant_id` | integer | Yes | ID of the restaurant whose table combinations to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tables

**Slug:** `GO_TABLE_LIST_TABLES`

Return one page of physical tables configured for a restaurant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `per_page` | integer | No | Maximum tables to return on this page (1-100). |
| `restaurant_id` | integer | Yes | ID of the restaurant whose tables to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Reservation

**Slug:** `GO_TABLE_UPDATE_RESERVATION`

Update selected details of an existing reservation, including its schedule, party, guest data, comments, duration, or table assignment. Omitted fields remain unchanged.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | New reservation date in YYYY-MM-DD format. Omit this field to leave the date unchanged. |
| `time` | string | No | New reservation time in HH:MM format. Omit this field to leave the time unchanged. |
| `comments` | string | No | New reservation comments. Pass null explicitly to clear them; omit this field to leave them unchanged. |
| `table_ids` | array | No | Replacement table IDs. Pass an empty list to remove all assignments. GoTable silently ignores IDs outside this restaurant. |
| `guest_name` | string | No | New guest name. Pass null explicitly to clear it; omit this field to leave it unchanged. |
| `party_size` | integer | No | New number of guests. Omit this field to leave the party size unchanged. |
| `table_lock` | boolean | No | Whether assigned tables should be locked. Omit this field to leave the setting unchanged. |
| `guest_email` | string | No | New guest email address. Pass null explicitly to clear it; omit this field to leave it unchanged. |
| `restaurant_id` | integer | Yes | ID of the restaurant that owns the reservation. |
| `reservation_id` | integer | Yes | ID of the reservation to update. |
| `guest_telephone` | string | No | New guest telephone number. Pass null explicitly to clear it; omit this field to leave it unchanged. |
| `duration_in_minutes` | integer | No | New duration in minutes. Omit this field to leave the duration unchanged. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |