PIpismo
Marketplace

Create marketplace V3

This endpoint creates a new marketplace. This endpoint generates a <a href="https://developers.pismo.io/events/docs/marketplace-marketplace-created-2">Marketplace created</a> event.

post/v3/marketplaces

Request

  • Base URL
    https://sandbox.pismolabs.io/sellers
  • URL
    https://sandbox.pismolabs.io/sellers/v3/marketplaces
  • Auth
    none declared

Request body

brand_namestring required

Marketplace brand name. A secondary name for the marketplace that is not the legal registered name

document_numberstring required

Marketplace document number. This is the government document code, such as a government-issued tax ID

marketplace_namestring required

Registered, legal marketplace name

registrationstring

Municipal registration number. In some countries the municipal registration is called a business license

registration2string

Additional municipal registration number. In some countries, two munipal registration numbers are required — one for the country and another for the state

external_idstring

Marketplace ID used on client's system

Example request

{
  "brand_name": "Acme",
  "document_number": "20166135000139",
  "marketplace_name": "Acme Products, LLC",
  "registration": "123.456.789",
  "registration2": "123.456.790",
  "external_id": "1123",
  "address": {
    "number": 22,
    "street": "Maple Avenue",
    "complementary_address": "Suite 2",
    "neighborhood": "West End",
    "zip_code": "91941",
    "city": "San Diego",
    "state": "CA",
    "country": "United States"
  },
  "contact": {
    "name": "Jane Doe",
    "email": "email@email.com",
    "phone_number": "5558739452",
    "additional_phone_number": "5558739453"
  }
}

Response

Create marketplace

idinteger

Marketplace ID

Example response

{
  "id": 51148
}

Changes

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