Create Seller POST

URL: https://api.painelalter.com/api/seller/create

Creates a new seller and adds it to all the given stores. The token user must have access to every store in alias_ids.

The seller is included in the running and future goals of each store. If isVezActive is true, the seller is also enrolled in the AlterVez queues of the stores that have the service.

Body Parameters

Parameter	Type	Description
alias_ids	array	List of the alias IDs (strings) of the stores the seller will be added to. Must contain at least one store.
nameSeller	string	Seller name.
seller_alias_id	string	Seller alias ID. Must be unique in each store; if it already exists in any of the stores, the request is rejected with status 409 Conflict.
isVezActive [OPTIONAL]	boolean	Whether the seller takes part in AlterVez. Accepts true, false, 1 or 0. Default: false.
onboardUtcDatetime [OPTIONAL]	string	Seller onboard date and time in the stores, in UTC. Format YYYY-MM-DDTHH:mm:ss. Default: current date and time.

TIP

Send the seller_alias_id so the seller can later be fetched and edited through the other seller endpoints, which identify it by this field.

Example Body

{
  "alias_ids": ["STORE-10", "STORE-11"],
  "nameSeller": "Ana",
  "seller_alias_id": "SELL-001",
  "isVezActive": true,
  "onboardUtcDatetime": "2026-10-01T12:00:00"
}

Response Example

Status 201 Created

{
  "seller": {
    "alias_id": "SELL-001",
    "nameSeller": "Ana",
    "isVezActive": 1,
    "stores_alias_id": ["STORE-10", "STORE-11"]
  }
}