# Composing API Requests

The **Composer** in Fiddler Everywhere allows you to create requests to REST and SOAP API endpoints. Requests to local and online APIs enable you to check and debug various endpoints, inspect and analyze requests and responses, and quickly retrieve and receive data. To load the **Composer**:

1. Start Fiddler Everywhere and open the **Home** Pane.

2. Follow the **Composer** flow from the **Compose API Request** section.

OR

1. Start Fiddler Everywhere and open the **Composer** pane.

As a result, Fiddler loads the **Composer** screen where you can compose and execute HTTP requests and organize them in collections through the **Requests** tree.

![the Composer pane in Fiddler Everywhere](https://www.telerik.com/fiddler/fiddler-everywhere/documentation/assets/ae58b961922980cdf30c041c251b8ba3/composer-main.png)

## Compose API Request

1. Use the **+** button to create a new **Composer** tab. Alternatively, you can directly use the main **Composer** tab.

2. Select **HTTP method** and enter the endpoint URL.

3. Select the HTTP protocol version with the drop-down menu to the left of the **Execute** button.

4. (Optional) Enter additional headers, parameters, and body if required. For example, common scenarios are to enter an authorization header, a **Content-type** header, or custom body data. Note that the request execution includes only checked headers.

   > important By default, the Fiddler Composer auto-generates the required default headers, including the `Host` header and the `User-Agent` header with the value `Fiddler Everywhere`. This `Host` header lets servers and network peers identify the targeted host and port number of the targeted server. The `User-Agent` agent is a characteristic string that enables servers and network peers to identify the application or version of the requesting user agent. Note that while you can uncheck and execute a request without the default headers, an HTTP request without `Host` header will return a server error as it is considered a malformed request.

5. Click **Execute** to send the composed API request.

Once the API request executes, you can inspect its HTTP Response in the Composer's **Response inspector** tab. Like the inspectors in the **Traffic** pane, the **Response** inspector provides multiple views such as **Headers**, **Raw**, **JSON**, and so on.

## Edit Captured API Request

1. Start Fiddler Everywhere and open the **Traffic** pane.
2. Capture a session (or open a session from the saved save **Snapshots** tree) and use the **Edit in Composer** option from the context menu.

As a result, the session loads as an HTTP request in the Fiddler **Composer**, where you can make atomic modifications to its structure. The **Composer** has a flexible user interface that allows you to switch between **Structured** and **Raw** content (refer to the screenshots below) and between **Table** or **Bulk** style inspectors.

* Using the **Structured** mode
  ![structured mode in Composer](https://www.telerik.com/fiddler/fiddler-everywhere/documentation/assets/2fbdcb3a5a376d4460e1a08f88fb0a11/composer-structured.png)
* Using the **Raw** mode
  ![raw mode in Composer](https://www.telerik.com/fiddler/fiddler-everywhere/documentation/assets/cea30564b915da6fc579ce4f73d90dfb/composer-raw.png)

## Save API Request

You can save the API request through the following steps.

* Open the **Composer** pane.
* [Compose your API request](https://www.telerik.com/fiddler/fiddler-everywhere/documentation/compose-api-requests/api-requests-composer#compose-api-request)
* Click the **Save** button.

Saved requests are loaded as a collection in the **Requests** list and can be reused or shared with collaborators at any later moment.

![Creating API request](https://www.telerik.com/fiddler/fiddler-everywhere/documentation/assets/a3edef3412019dce0c214af933fd2069/comp-pane-all.png)

## Share Requests Collection

With Fiddler Everywhere, you can quickly share a collection of saved API requests.

* Open the **Request** list.
* Select a collection of saved API requests.
* Use the context menu to share the collection with collaborators.

![Share API requests](https://www.telerik.com/fiddler/fiddler-everywhere/documentation/assets/f48e073974698044a455478aed260f78/comp-requests-share.png)

## See Also

* [Grouping API Requests in Collections](https://www.telerik.com/fiddler/fiddler-everywhere/documentation/compose-api-requests/api-requests-collections)
* [Sharing Captured Traffic and Requests](https://www.telerik.com/fiddler/fiddler-everywhere/documentation/collaboration/sharing-data)
* [Modifying Traffic with Rules](https://www.telerik.com/fiddler/fiddler-everywhere/documentation/modify-and-filter-traffic/modify-traffic-with-rules)
