---
title: "Cria um buyer"
method: POST
path: "/v2/buyers"
tags: ["API v2 para criação de Buyers"]
---

# Cria um buyer

`POST /v2/buyers`

Cria um buyer e retorna o seu identificador (UUID) junto aos dados fornecidos

## Request body

- CreateBuyerV2Request
  - `document` DocumentRequest, required
    - `documentNumber` string, required — Número do documento
    - `documentType` 'cpf' | 'cnpj', required — Tipo do documento
    - `documentNation` string, required — País do documento
  - `name` string, required
  - `email` string, email, required
  - `countryCode` string
  - `phone` string, required
  - `alternativeEmail` string, email
  - `address` AddressSellerClientRequest
    - `street` string
    - `number` string
    - `complement` string
    - `district` string
    - `city` string
    - `state` string
    - `country` string
    - `zipCode` string

## Response `201`

buyer cadastrado com sucesso.

- BuyerV2Response
  - `uuid` string
  - `document` string
  - `name` string
  - `countryCode` string
  - `phone` string
  - `email` string
  - `alternativeEmail` string

## Other responses

- `400` — Requisição inválida
- `401` — Não autorizado
- `403` — Acesso proibido
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada.md) · [All operations](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/barte/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1/schema)