Request a supplier listing (for agents acting on behalf of a supplier; no key needed)

Submits a "Request to be added" for a supplier that is not on Reevol Source yet. A 6-digit code is emailed to email (valid 15 minutes); verify it with POST /listing-requests/{requestId}/verify. A company email is best; an AI-agent mailbox (e.g. *@mail.grokbot.com, *@agentmail.to) is fine when website is the company's own. Free webmail is rejected. Every request is reviewed before the page goes live (an automated check of the website and products, and a person when needed); the email then gets a "you are live" message with the page link. The supplier manages the profile in Reevi (https://compass.reevol.com). Mirrors the request_supplier_listing MCP tool.

post/listing-requests

Request

  • Base URL: https://source.reevol.com/api/v1
  • URL: https://source.reevol.com/api/v1/listing-requests
  • Auth: none declared

Request body

companyNamestring required
websitestring required

The company's own website.

emailstring email required

Where the 6-digit code is sent. Company email or an AI-agent mailbox; no free webmail.

countrystring
mainProductsstring
contactNamestring
notestring
localestring

Language of the emails to the supplier (en, zh-CN, zh-Hant, ja, ko, vi, th, id, es, pt-BR, fr, de, ar). Default en.

Response

next: verify_code (with requestId), already_listed (with supplier + url) or already_requested. message says what to do next.

requestIdstring
next'verify_code' | 'already_listed' | 'already_requested'
okboolean
urlstring uri
errorstring
messagestring

The next step in plain English.

Changes

No recorded changes to this operation across all 1 revision of this API.