--- title: "API Key, Software Development Kit (SDK), & Web Link | SpotOn Reserve" canonical: "https://help.spoton.com/space/SK/5050302466/API%20Key%2C%20Software%20Development%20Kit%20(SDK)%2C%20%26%20Web%20Link%20%7C%20SpotOn%20Reserve" format: markdown --- ## Overview SpotOn Reserve provides multiple ways to enable online Reservations and Waitlist access for your guests, including: - **API Key** – for fully custom developer-built integrations - **SDK (Widgets & Quick Buttons)** – for embedding reservations directly into your website - **Web Link** – for quick and simple online booking access **This article explains how to:** - Locate your Restaurant ID - Locate your Activity ID - Configure SDK widgets and Quick Buttons - Use Web Links for online reservations --- **Quick Links** > Macro (toc) --- # Step-by-Step Instructions --- #### **Access API Settings** 1. Log in to the **SpotOn Reserve Web Portal**. 2. From the left-side menu, select: **Settings → API** 3. Select **API Key**. This section contains: - API Key - SDK setup examples - Quick Button examples - Restaurant ID - Documentation links - Web Link options --- #### **Locate Your Restaurant ID** Your Restaurant ID is required for SDK widgets, Quick Buttons, and custom integrations. #### **Steps** 1. Go to: **Settings → API → API Key** 2. Scroll to the bottom of the page. 3. Locate the section labeled **Restaurant**. 4. Under **ID**, copy the numerical Restaurant ID value. This Restaurant ID is used anywhere the setup instructions say: ``` YOUR_RESTAURANT_ID ``` --- #### **Locate Your Activity ID (Experiences)** If you are using Experience reservations (such as Axe Throwing, Bowling, Billiards, etc.), you will also need the Activity ID. Each Experience has its own unique Activity ID. Examples: - Axe Throwing = one Activity ID - Billiards = different Activity ID --- #### **Steps to Find Your Activity ID** 1. Go to: **Settings → Experiences** 2. Open **Active Experiences**. 3. Locate the Experience activity you need. 4. Click the **gear icon** for that activity. 5. Once the settings page opens, look at the website URL in your browser. 6. Copy the numerical value shown at the end of the URL. That number is your **Activity ID**. This Activity ID is used anywhere the setup instructions say: ``` YOUR_ACTIVITY_ID ``` > You only need the numerical Activity ID value for SDK or Quick Button setup. --- #### **Configure SDK Widgets & Quick Buttons** SpotOn Reserve provides SDK widgets and Quick Buttons that can be embedded directly into your website. These widgets allow guests to: - Make reservations - Join a waitlist - Book specific experiences without leaving your website. --- #### **Setup Steps** 1. Go to: **Settings → API → API Key** 2. Copy the appropriate JavaScript or widget code for your setup. 3. Replace: - `YOUR_RESTAURANT_ID` - `YOUR_ACTIVITY_ID` (if applicable) 4. Add the updated code to your website. --- #### **SDK Widget Examples** Examples of available widgets and Quick Buttons can be viewed here: [https://sdk.seatninja.com/web/examples.html](https://sdk.seatninja.com/web/examples.html) --- #### **Single Activity Widget Example** You can also create a direct widget link for a specific Experience. Example: ``` https://reserve.spoton.com/web/restaurant-single-activity-small-widget.html?restaurantId=YOUR_RESTAURANT_ID&activityId=YOUR_ACTIVITY_ID ``` (Optional) Add a date parameter: ``` &date=YYYY-MM-DD ``` Replace: - `YOUR_RESTAURANT_ID` - `YOUR_ACTIVITY_ID` with your actual IDs. --- #### **Web Link Setup** SpotOn Reserve also provides a Web Link that can be copied and pasted onto: - Your website - Reservation buttons - Social media pages - Email campaigns - Text marketing campaigns #### S**teps** 1. Navigate to: **Settings → API** 2. Copy the Web Link. 3. Paste it where guests can access reservations online. 4. Open the link to confirm your landing page information is correct. --- #### **Manage Your Landing Page Profile** Your guest-facing reservation page can be managed under: **Settings → API → Profile** You can update: - Restaurant description - Tagline - Cuisine - Amenities - Website and social links - Photos and branding images > High-resolution images are strongly recommended. --- # FAQs **What is the difference between Restaurant ID and Activity ID?** - **Restaurant ID** identifies your restaurant location. - **Activity ID** identifies a specific Experience activity. Both may be required depending on your setup. --- **Where do I find my Restaurant ID?** Go to: **Settings → API → API Key** Scroll to the bottom of the page and locate the **Restaurant ID** under the Restaurant section. --- **Where do I find my Activity ID?** Go to: **Settings → Experiences** Open the specific activity using the gear icon and copy the numerical value at the end of the URL. --- **Do I need both IDs?** - Standard reservation widgets may only require a Restaurant ID. - Experience widgets typically require both a Restaurant ID and Activity ID. --- **Can I use the Web Link instead of SDK setup?** Yes. The Web Link is the simplest setup option and does not require coding. --- **Where can developers find implementation documentation?** Developer documentation is available here: [https://developers.spoton.com/reserve/docs](https://developers.spoton.com/reserve/docs) --- # Tips - Make sure Restaurant ID and Activity ID are entered correctly. - Only copy the numerical Activity ID value. - Confirm the Experience activity is active before testing. - Test all widgets and buttons after implementation. - Use high-resolution photos for your landing page. - If widgets are not loading, confirm IDs were replaced properly. --- ## Related Articles - [Waitlist Party Profiles | SpotOn Reserve Host App](https://help.spoton.com/space/SK/1365508151/Waitlist+Party+Profiles+%7C+SpotOn+Reserve+Host+App) - [Dining Room Setup & Editing | SpotOn Reserve Web Portal](https://help.spoton.com/space/SK/1458897279/Dining+Room+Setup+&+Editing+%7C+SpotOn+Reserve+Web+Portal) - [Confirming Reservations | SpotOn Reserve Host App](https://help.spoton.com/space/SK/1284081339/Confirming+Reservations+%7C+SpotOn+Reserve+Host+App) - [Restore a Canceled Guest to the Waitlist | SpotOn Reserve Host App](https://help.spoton.com/space/SK/1366425672/Restore+a+Canceled+Guest+to+the+Waitlist+%7C+SpotOn+Reserve+Host+App) - [Guest Search | SpotOn Reserve Host App](https://help.spoton.com/space/SK/1366295933/Guest+Search+%7C+SpotOn+Reserve+Host+App)