Accept seller lead

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 endpoint, and resending the invite through the Resend seller lead's Invite endpoint.

Permissions

Any user or API key must have at least one of the appropriate License Manager resources 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 with that resource or use one of the following predefined roles:

Role	Resource
Seller manager	Save Seller

❗ Assigning a predefined role to users or application keys usually grants permission to multiple License Manager resources. 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.

accountNamestring required

Example:apiexamples

Name of the VTEX account that belongs to the marketplace. The notification will be posted into this account.

environmentstring required

Environment to use. Used as part of the URL.

sellerIdstring required

Example:seller123

A string that identifies the seller in the marketplace. This ID must be created by the marketplace and informed to the seller before the integration is built.

Content-Typestring required

Type of the content being sent.

Request body

sellerEmailstring required

Seller's contact email.

sellerNamestring required

Seller's store's name.

sellerAccountNamestring required

Name of the seller's account, part of the url of their VTEX Admin.

salesChannelstring required

Sales channel (trade policy) associated to the seller account created.

emailstring required

email of the admin responsible for the seller.

sellerTypeinteger required

Type of seller, including:

1: Regular seller

2: White label seller.

accountIdstring required

Marketplace's account ID.

documentstring required

Company's legal document code.

hasAcceptedLegalTermsboolean required

Indicates if the seller has accepted the platform's legal terms and conditions.

Example request

{
  "sellerEmail": "selleremail@email.com",
  "sellerName": "Seller Name",
  "sellerAccountName": "seller123",
  "salesChannel": "1",
  "email": "seller@email.com",
  "sellerType": 1,
  "accountId": "5fb38ace-d95e-45ad-970d-ee97cce9fbcd",
  "document": "12345671000",
  "hasAcceptedLegalTerms": true,
  "address": {
    "postalcode": "12345678",
    "complement": "Appartment 1234",
    "street": "Park Avenue",
    "number": "25",
    "neighborhood": "Manhattan",
    "state": "RJ",
    "city": "Rio de Janeiro"
  },
  "accountable": {
    "name": "Jane Smith",
    "email": "email@email.com",
    "phone": "1234567890"
  }
}

Response

OK

v50

Accept seller lead

Permissions

Path parameters

Headers

Request body

Example request

Response