# Embedded Testing Tool

> Test your embedded eSignature solution with the Dropbox Sign API Embedded Testing Tool.

You can use this tool to quickly test any of Dropbox Sign's Embedded flows without having to write a single line of JavaScript.

This is mostly an interactive page, meaning you will find embedded consoles along the way. These embedded consoles will allow you to send API requests without having to navigate away from this page.

<Note icon="fa-light fa-triangle-exclamation">
  * The Parameters and Body sections on the embedded consoles can be modified as needed.
  * When the page is refreshed, the outputs from the embedded consoles will be cleared.
</Note>

## Prerequisites

You will need the following:

* Your [API key](https://app.hellosign.com/home/myAccount?current_tab=api), to send requests using the embedded consoles.
* Your API App's client ID, which you can get using the embedded console in the [List Available API Apps](#list-available-api-apps) section below.
* An embedded URL:
  * `sign_url`
  * `edit_url`
  * `claim_url`
* You can generate embedded URLs using the embedded consoles in the [Generate Embedded URLs](#generate-embedded-urls) section below.

<EmbeddedWrapper />

<Note icon="fa-light fa-triangle-exclamation">
  This tool uses Dropbox Sign's client-side [library](https://github.com/hellosign/hellosign-embedded) to load documents on an iFrame.
</Note>

## List Available API Apps

<RunnableEndpoint endpoint="GET /api_app/list" collapsed={true} />

<Warning icon="fa-light fa-circle-exclamation">
  This section will update with a list of all Client IDs associated with the API key used.
</Warning>

## Generate Embedded URLs

### Embedded Signing

<RunnableEndpoint endpoint="POST /signature_request/create_embedded" collapsed={true} />

<Warning icon="fa-light fa-circle-exclamation">
  You'll need to first create an embedded signature request using the embedded console above before moving on to the next step.
</Warning>

<RunnableEndpoint endpoint="GET /embedded/sign_url/{signature_id}" collapsed={true} />

<Warning icon="fa-light fa-circle-exclamation">
  This section will update with the unique `sign_url` for the selected signer from the signature request created previously.
</Warning>

### Embedded Templates

<RunnableEndpoint endpoint="POST /template/create_embedded_draft" collapsed={true} />

<Warning icon="fa-light fa-circle-exclamation">
  You'll need to create an embedded template draft using the embedded console above to obtain an `edit_url`.
</Warning>

### Embedded Requesting

<RunnableEndpoint endpoint="POST /unclaimed_draft/create_embedded" collapsed={true} />

<Warning icon="fa-light fa-circle-exclamation">
  You'll need to create an unclaimed draft using the embedded console above to obtain a `claim_url`.

  **Note:** Please ensure the `test_mode` parameter is set to `true` in the **Body** section of the embedded console.
</Warning>