---
title: Create and run an API test
description: >-
  Learn how to create and run an API test in Kapptivate, from opening a live
  session to saving and executing your scenario.
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

This guide shows you how to create an API test in a few steps, from the live session to scenario execution.

## Interactive tutorial

<iframe src="https://scribehow.com/embed/Comment_creer_et_executer_un_test_API__G2629W4kTt6vkIOzNdy3NA?skipIntro=true" width="100%" height="640" allowFullScreen frameBorder="0"></iframe>

---

## Step-by-step guide

<Steps>
  <Step title="Open a live session">
    From the Kapptivate portal, click **Live session**, then select **Web** to access the web agent.
  </Step>
  <Step title="Enter the API URL">
    In the "Enter the request URL" field, type the URL of your API endpoint.
  </Step>
  <Step title="Execute manually">
    Click the green button to run the API call and check the response.
  </Step>
  <Step title="Check history">
    Click **History** to view previous API calls.
  </Step>
  <Step title="Add to scenario">
    Add the API call step to your test step list.
  </Step>
  <Step title="Create the test">
    Click **Create the test** and give it a descriptive name.
  </Step>
  <Step title="Save and execute">
    Click **Save and execute** to verify the scenario works.
  </Step>
  <Step title="Check the results">
    Review the execution status to confirm the test is operational.
  </Step>
</Steps>

## What's next?

<Columns cols={2}>
  <Card title="API actions" icon="code" href="/tests/actions/api/overview">
    Explore the available actions for API tests.
  </Card>
  <Card title="Create a monitor" icon="chart-line" href="/guides/monitors-create-delete">
    Schedule regular execution of your tests.
  </Card>
</Columns>