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

# Cria um buyer

`POST /v2/buyers`

## Request

- Base URL: `https://api.barte.com`
- URL: `https://api.barte.com/v2/buyers`
- Auth: API key in header `X-Token-Api`
- TypeScript: <https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/docs/v2/buyers/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/barte/apis/api-de-sellers-v2-atualizada.md) - [All operations](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/llms.txt) - [OpenAPI document](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1?raw)