Delv
Hoppscotch
Getting Started Guide

How to Use Hoppscotch

A practical guide to get you up and running with Hoppscotch. Written by Delv Editorial, Delv Team.

Getting started with Hoppscotch

In this guide, you'll learn how to set up and use Hoppscotch to build and test APIs effectively. By the end, you'll be able to make API requests and view responses in a user-friendly interface.

Step 1: Sign up and set up

  1. Go to the Hoppscotch website.
  2. Click on the "Get Started" button on the homepage.
  3. You can start using Hoppscotch directly in your browser without signing up, as it is entirely free.

Step 2: Your first API request

  1. In the top-left corner, select the type of request you want to make (GET, POST, PUT, DELETE) using the dropdown menu.
  2. Enter the API endpoint URL in the "Enter request URL" field.
  3. If you're making a POST request, click on the "Body" tab below the URL field. Choose the format (e.g., JSON) and input your data.
  4. Add any necessary headers by clicking on the "Headers" tab and entering key-value pairs.
  5. Click the “Send” button to execute your request.
  6. View the response in the panel below, which includes status code, response time, and data.

Step 3: Get better results

  • To save your requests, click the "Save" button at the top right. This allows you to organise your requests into collections for easy access later.
  • Use the “History” tab to quickly revisit previous requests.
  • For testing, you can use the “Tests” tab to write JavaScript code that checks the response and ensures it meets your expectations.

Pro tip

Use the "Collections" feature to group related API requests together. This will save you time when testing multiple endpoints of the same API, as you can quickly switch between them.

Common mistake to avoid

Many users forget to set the correct headers, especially the 'Content-Type' for POST requests. Always double-check your headers to avoid issues with data not being recognised by the API.