Creating API requests

In the API Test Editor, you can create, configure, and send requests to the API under test. There are two ways to create a request in the API Test Editor:

• Use the step builder
• Import step from cURL

Use the step builder

To create a request directly in the API Test Editor, click on the + Add step button and enter the following information into the Request details section:

1. Give the request a name. Naming requests helps other members of your workspace understand the purpose of the request.
2. Select an HTTP method: GET, POST, PUT, PATCH, FETCH, DELETE, HEAD, or OPTIONS.
3. Enter the URL. Use mabl variable syntax to reference the base URL: api.url. For example, if the api.url is https://example.com/api and you want to make a request to https://example.com/api/users, enter {{@api.url}}/users in the URL field.
4. Use the following tabs to configure any additional settings that the API requires, including:
   • Auth - send authentication or authorization settings with your API request
   • Params - append params as key-value pairs to the API URL
   • Headers - enter request headers as key-value pairs
   • Body - add or update data, including uploading files.
   • Pre-request - run JavaScript code before the request is made. See the article on adding scripts for more details.
   • Settings - apply settings to the request as key-value pairs

Building a request in the step builder 

Import step from cURL

If you prefer to work with cURL requests, use the following steps to import a cURL request into the Editor:

1. Click on the down arrow next to Add step and select Import step from cURL.
2. Paste in your cURL request and import it.

Importing a cURL request

Next steps

After creating a request, use the Validation and variable assignment section to make assertions and create variables from the response of an API step.