Cvent Social Tables

Cvent Social Tables Guests API

The Guests API from Cvent Social Tables — 12 operation(s) for guests.

GitHub OpenAPI

Operations 17

POST /4.0/guestlists/{guestlist_id}/guests/meals assign/delete multiple guests to a tag
POST /4.0/guestlists/{guestlist_id}/guests/tags assign/delete multiple guests to a tag
POST /4.0/guestlists/{guestlist_id}/guests Add a guest to a guestlist
GET /4.0/guestlists/{guestlist_id}/guests Retrieve all guests for a guestlist
POST /4.0/guestlists/{guestlist_id}/guests/_bulk add multiple guests to a guestlist
POST /4.0/guestlists/{guestlist_id}/guests/_dedupe dedupe new guests against existing guests in a guestlist
POST /4.0/guestlists/{guestlist_id}/guests/_replace deletes existing guests that match new duplicate guests
GET /4.0/guestlists/{guestlist_id}/guests/{guest_id} Retrieve a guest
PATCH /4.0/guestlists/{guestlist_id}/guests/{guest_id} update a guest
PUT /4.0/guestlists/{guestlist_id}/guests/{guest_id} update a guest
DELETE /4.0/guestlists/{guestlist_id}/guests/{guest_id} Delete a guest & remove from group
POST /4.0/guestlists/{guestlist_id}/guests/{guest_id}/checkin Updates the checkin status of an individual guest
POST /4.0/guestlists/{guestlist_id}/guests/{guest_id}/restore Restore a deleted guest and their group if applicable
GET /4.0/guestlists/{guestlist_id}/guests/{guest_id}/seating Retrieve a guest with seating information
POST /4.0/guestlists/{guestlist_id}/guests/{guest_id}/seating Seats a guest and any grouped guests with them
GET /4.0/guestlists/{guestlist_id}/guests/seating Retrieve all guests and their seatings for a guestlist
GET /4.0/guestlists/team/{team_id}/guests/_filter Retrieve all guests matching specified filter

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/cvent-social-tables/refs/heads/main/openapi/cvent-social-tables-guests-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/cvent-social-tables/refs/heads/main/overlays/cvent-social-tables-guests-api-overlay.yaml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/cvent-social-tables-guests-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cvent-social-tables-guests-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Social Tables API Gateway Authentication Guests API
  version: 4.0.0
  description: The Social Tables API
servers:
- url: https://api.socialtables.com/
tags:
- name: Guests
paths:
  /4.0/guestlists/{guestlist_id}/guests/meals:
    post:
      tags:
      - Guests
      summary: assign/delete multiple guests to a tag
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: collections for gueslist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/guests-guest-list-service'
        '400':
          description: Error adding or removing meals
        '410':
          description: guestlist is deleted
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - action
              - guests
              - meals
              properties:
                action:
                  description: action to redirect to
                  type: string
                  enum:
                  - CREATE
                  - DELETE
                meals:
                  type: array
                  items:
                    type: string
                guests:
                  type: array
                  items:
                    type: string
        description: body object
        required: true
  /4.0/guestlists/{guestlist_id}/guests/tags:
    post:
      tags:
      - Guests
      summary: assign/delete multiple guests to a tag
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: tag for guestlist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/tags-guest-list-service'
        '400':
          description: Error adding or removing tags
        '410':
          description: guestlist is deleted
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - action
              - guests
              - tags
              properties:
                tags:
                  type: array
                  items:
                    type: string
                action:
                  type: string
                guests:
                  type: array
                  items:
                    $ref: '#/components/schemas/guests-guest-list-service'
        description: body object
        required: true
  /4.0/guestlists/{guestlist_id}/guests:
    post:
      tags:
      - Guests
      summary: Add a guest to a guestlist
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: guest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/guests-guest-list-service'
        '400':
          description: Error creating guest
        '410':
          description: guestlist is deleted
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/guests-guest-list-service'
        required: true
    get:
      tags:
      - Guests
      summary: Retrieve all guests for a guestlist
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: returns guests
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/guests-guest-list-service'
        '410':
          description: guestlist is deleted
  /4.0/guestlists/{guestlist_id}/guests/_bulk:
    post:
      tags:
      - Guests
      summary: add multiple guests to a guestlist
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: collections for gueslist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/guests-guest-list-service'
        '400':
          description: Error creating guests
        '410':
          description: guestlist is deleted
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - action
              - guests
              properties:
                action:
                  type: string
                  default: CREATE
                  enum:
                  - CREATE
                  - DELETE
                  - UPDATE
                  description: CREATE | DELETE | UPDATE
                guests:
                  type: array
                  items:
                    $ref: '#/components/schemas/guests-guest-list-service'
        description: body object
        required: true
  /4.0/guestlists/{guestlist_id}/guests/_dedupe:
    post:
      tags:
      - Guests
      summary: dedupe new guests against existing guests in a guestlist
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: returns guests
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/guests-guest-list-service'
        '410':
          description: guestlist is deleted
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/guests-guest-list-service'
        required: true
  /4.0/guestlists/{guestlist_id}/guests/_replace:
    post:
      tags:
      - Guests
      summary: deletes existing guests that match new duplicate guests
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: returns guests
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/guests-guest-list-service'
        '410':
          description: guestlist is deleted
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/guests-guest-list-service'
        required: true
  /4.0/guestlists/{guestlist_id}/guests/{guest_id}:
    get:
      tags:
      - Guests
      summary: Retrieve a guest
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      - name: guest_id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: returns guest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/guests-guest-list-service'
        '410':
          description: guestlist is deleted
    patch:
      tags:
      - Guests
      summary: update a guest
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      - name: guest_id
        description: guest ID
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: success, guest patched
        '410':
          description: guestlist is deleted
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/guests-guest-list-service'
    put:
      tags:
      - Guests
      summary: update a guest
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      - name: guest_id
        description: guest ID
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: success, guest updated
        '410':
          description: guestlist is deleted
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/guests-guest-list-service'
    delete:
      tags:
      - Guests
      summary: Delete a guest & remove from group
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      - name: guest_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: successfully deleted
        '400':
          description: Error with no id
        '404':
          description: Error with invalid id
        '405':
          description: Error with no id
        '410':
          description: guestlist is deleted
  /4.0/guestlists/{guestlist_id}/guests/{guest_id}/checkin:
    post:
      tags:
      - Guests
      summary: Updates the checkin status of an individual guest
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      - name: guest_id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: checkin
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/guests-guest-list-service'
        '400':
          description: Error setting guests checkin status
        '410':
          description: guestlist is deleted
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/guests-guest-list-service'
        required: true
  /4.0/guestlists/{guestlist_id}/guests/{guest_id}/restore:
    post:
      tags:
      - Guests
      summary: Restore a deleted guest and their group if applicable
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      - name: guest_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successfully restored guest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/guests-guest-list-service'
        '401':
          description: Unauthorized
        '404':
          description: Guestlist or guest not found
        '410':
          description: Guestlist is deleted
  /4.0/guestlists/{guestlist_id}/guests/{guest_id}/seating:
    get:
      tags:
      - Guests
      summary: Retrieve a guest with seating information
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      - name: guest_id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: returns guest with seating information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/guestsWithSeating-guest-list-service'
        '410':
          description: guestlist is deleted
    post:
      tags:
      - Guests
      summary: Seats a guest and any grouped guests with them
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      - name: guest_id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: returns the diagram update
        '410':
          description: guestlist is deleted
  /4.0/guestlists/{guestlist_id}/guests/seating:
    get:
      tags:
      - Guests
      summary: Retrieve all guests and their seatings for a guestlist
      parameters:
      - name: guestlist_id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: returns guests with seatings
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/guestsWithSeating-guest-list-service'
        '410':
          description: guestlist is deleted
  /4.0/guestlists/team/{team_id}/guests/_filter:
    get:
      tags:
      - Guests
      summary: Retrieve all guests matching specified filter
      parameters:
      - name: team_id
        required: true
        in: path
        schema:
          type: string
      - name: filter_key
        required: true
        in: query
        schema:
          type: string
      - name: filter_value
        required: true
        in: query
        schema:
          type: string
      - name: event_ids
        required: true
        in: query
        schema:
          type: string
      responses:
        '200':
          description: returns guests matching specified filter
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/guests-guest-list-service'
        '404':
          description: no guests found
components:
  schemas:
    guestsWithSeating-guest-list-service:
      type: object
      properties:
        id:
          type: string
          description: id of guest
        first_name:
          type: string
          description: first name of guest
        last_name:
          type: string
          description: last name of guest
        email:
          type: string
          description: email address
        checked_in_status:
          type: object
          description: checkin data
          properties:
            checked_in:
              type: integer
            checked_in_at:
              type: string
              format: date-time
            checked_out_at:
              type: string
              format: date-time
        tags:
          type: array
          items:
            $ref: '#/components/schemas/tags-guest-list-service'
        meals:
          type: array
          items:
            $ref: '#/components/schemas/meals-guest-list-service'
        seating:
          type: object
          description: seating data
          properties:
            table_name:
              type: string
            table_number:
              type: string
            seat_number:
              type: string
            section_name:
              type: string
      required:
      - id
      - first_name
      - last_name
    meals-guest-list-service:
      type: object
      properties:
        title:
          type: string
          description: name of meal
      required:
      - title
    tags-guest-list-service:
      type: object
      properties:
        title:
          type: string
          description: title of tag
        color:
          type: string
          description: color of tag
      required:
      - title
    guests-guest-list-service:
      type: object
      properties:
        id:
          type: string
          description: id of guest
        first_name:
          type: string
          description: first name of guest
        last_name:
          type: string
          description: last name of guest
        email:
          type: string
          description: email address
        checked_in_status:
          type: object
          description: checkin data
          properties:
            checked_in:
              type: integer
            checked_in_at:
              type: string
              format: date-time
            checked_out_at:
              type: string
              format: date-time
        tags:
          type: array
          items:
            $ref: '#/components/schemas/tags-guest-list-service'
        meals:
          type: array
          items:
            $ref: '#/components/schemas/meals-guest-list-service'
      required:
      - id
      - first_name
      - last_name
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          scopes:
            authenticated: any authentication whatsoever
            create:oauth_client: oauth client create
            userdata: All of the things.
          authorizationUrl: https://auth.socialtables.com/oauth/authorize
          tokenUrl: https://auth.socialtables.com/oauth/token
      description: OAuth
    user_token:
      type: apiKey
      name: user_token
      in: header
      description: Social Tables User Token
    partner_token:
      type: apiKey
      name: partner_token
      in: header
      description: Social Tables Partner Token