---
title: "Accept seller lead"
method: PUT
path: "/seller-register/pvt/seller-leads/{sellerLeadId}"
tags: ["Seller Invite"]
---

# Accept seller lead

`PUT /seller-register/pvt/seller-leads/{sellerLeadId}`

This endpoint is triggered by the seller onboarding wizard, once the seller confirms their invitation. It can be used by marketplace operators to manually accept seller leads, and carry on with their onboarding process. 

Note that there's no specific API call that allows status changes. The operations only allow the seller lead to move forward: 

 From `invite` > to `Accept` > closing on `[Create seller](https://developers.vtex.com/docs/api-reference/marketplace-apis/#put-/seller-register/pvt/seller-leads/-sellerLeadId-/seller)`.  

If you want to change the status, you can start the process again, by deleting that lead through the *[Delete seller lead](https://developers.vtex.com/docs/api-reference/marketplace-apis/#delete-/seller-register/pvt/seller-leads/-sellerLeadId-)* endpoint, and resending the invite through the *[Resend seller lead's Invite](https://developers.vtex.com/docs/api-reference/marketplace-apis/#put-/seller-register/pvt/seller-leads/-sellerLeadId-/status)* endpoint. 

## Permissions

Any user or [API key](https://developers.vtex.com/docs/guides/api-authentication-using-api-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this request. Otherwise they will receive a status code `403` error. These are the applicable resources for this endpoint:

| **Product** | **Category** | **Resource** |
| --------------- | ----------------- | ----------------- |
| Seller Register | Seller Administration | **Save Seller** |

You can [create a custom role](https://help.vtex.com/en/tutorial/roles--7HKK5Uau2H6wxE1rH5oRbc#creating-a-role) with that resource or use one of the following [predefined roles](https://help.vtex.com/en/tutorial/predefined-roles--jGDurZKJHvHJS13LnO7Dy):

| **Role** | **Resource** | 
| --------------- | ----------------- | 
| Seller manager | Save Seller |

>❗ Assigning a [predefined role](https://help.vtex.com/en/tutorial/predefined-roles--jGDurZKJHvHJS13LnO7Dy) to users or application keys usually grants permission to multiple [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3). If some of these permissions are not necessary, consider creating a custom role instead. For more information regarding security, see [Best practices for using application keys](https://help.vtex.com/en/tutorial/best-practices-api-keys--7b6nD1VMHa49aI5brlOvJm).

## Path parameters

- `accountName` string, required
- `environment` string, required
- `sellerId` string, required

## Headers

- `Content-Type` string, required

## Request body

- AcceptSellerLeadRequest — Request to accept a seller lead. This includes detailed information about the seller, such as their email, name, account name, trade policy, contact email, seller type, account ID, document details, acceptance of legal terms, address, and accountable party.
  - `sellerEmail` string, required — Seller's contact email.
  - `sellerName` string, required — Seller's store's name.
  - `sellerAccountName` string, required — Name of the seller's account, part of the url of their VTEX Admin.
  - `salesChannel` string, required — Sales channel ([trade policy](https://help.vtex.com/en/tutorial/how-trade-policies-work--6Xef8PZiFm40kg2STrMkMV)) associated to the seller account created.
  - `email` string, required — email of the admin responsible for the seller.
  - `sellerType` integer, required — Type of seller, including: `1`: Regular seller `2`: White label seller.
  - `accountId` string, required — Marketplace's account ID.
  - `document` string, required — Company's legal document code.
  - `hasAcceptedLegalTerms` boolean, required — Indicates if the seller has accepted the platform's legal terms and conditions.
  - `address` Address, required — Details of the address associated with the seller. This includes postal code, complement, street, number, neighborhood, state, and city.
    - `postalcode` string, required — Postal code from the seller's address.
    - `complement` string, required — Seller's address complement.
    - `street` string, required — Street information, from the seller's address.
    - `number` string, required — Street's number, from the seller's address.
    - `neighborhood` string, required — Seller's address neighborhood.
    - `state` string, required — State, from the seller's address.
    - `city` string, required — City name, from the seller's address.
  - `accountable` Accountable, required — Details of the person accountable for the seller's account. This includes their name, email address, and phone number.
    - `name` string, required — Name of the person responsible for the seller.
    - `email` string, required — Email address of the person responsible for the seller.
    - `phone` string, required — Phone number of the person responsible for the seller.

## Response `200`

OK

---

[API](https://skmtc.net/vtex/apis/marketplace-api.md) · [All operations](https://skmtc.net/vtex/apis/marketplace-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vtex/marketplace-api/revisions/27e83b4cc9ac/schema)