# Create and embed a form request

Source: https://developer.avalara.com/products/avalara-1099-and-w9/integration-guides/1099-and-w-9/rxp9650630495874/

Guide: 1099 & W-9

# Create and embed a form request

Create and send an embedded W-9 or W-8 form request using the API, then copy the response to use in your integration.

Before you begin

Sign in to the API documentation portal and make sure you can access the Embedded W-9/W-8 section.

About this task

Create a form request through the API and prepare the response to embed in your application.

Steps

1.  In the API documentation, open Create form request in the Embedded W-9/W-8 section.
2.  Select Try it out.
3.  Ensure that `team_api_id` is populated.
    1.  If `team_api_id` is empty, retrieve it from the Settings > API tab in the Avalara 1099 & W-9 application.
4.  Replace the example content in the **Request body** with the JSON that you copied in the previous step.
5.  Replace `YOUR_ID_FOR_VENDOR` with your own reference ID (for example, a vendor ID from your system).
6.  Select Execute.

    Confirm that you receive a **201 Created** response.

    Note

    If you receive a `team_api_id` error, ensure that the value is correctly populated and retry the request.

7.  In the **Server response** section, copy the full response body.

    Verify that your `reference_id` appears in the response.