---
title: "Register a new buyer"
method: POST
path: "/v1/buyers"
tags: ["Buyers"]
---

# Register a new buyer

`POST /v1/buyers`

Register a new buyer

## Request body

- EdubankBuyerDto
  - `first_name` string, required — Buyer's first name
  - `last_name` string, required — Buyer's last name
  - `email` string — Buyer's email
  - `taxpayer_id` string, required — Buyer's CPF/CNPJ
  - `birthdate` string — Buyer's date of birth
  - `phone_number` string — Buyer's phone number
  - `address` EdubankBuyersAddress, required
    - `city` string, required — City
    - `additional_information` string — Additional address data. In this field you can inform complement, references
    - `number` string, required — Number
    - `state_code` string, required — State (UF)
    - `street` string, required — Street / Patio
    - `neighborhood` string, required — Neighborhood
    - `zip` string, required — Postal Zone / ZIP Code)
    - `country_code` 'BR', required — Buyer's country code

## Response `201`

The object has been successfully created

- EdubankBuyers
  - `id` string — Buyer id
  - `first_name` string, required — Buyer's first name
  - `last_name` string, required — Buyer's last name
  - `email` string — Buyer's email
  - `taxpayer_id` string, required — Buyer's CPF/CNPJ
  - `birthdate` string — Buyer's date of birth
  - `phone_number` string — Buyer's phone number
  - `address` EdubankBuyersAddress, required
    - `city` string, required — City
    - `additional_information` string — Additional address data. In this field you can inform complement, references
    - `number` string, required — Number
    - `state_code` string, required — State (UF)
    - `street` string, required — Street / Patio
    - `neighborhood` string, required — Neighborhood
    - `zip` string, required — Postal Zone / ZIP Code)
    - `country_code` 'BR', required — Buyer's country code

## Other responses

- `400` — Client specified an invalid argument, request body or query param
- `401` — The user is unauthorized
- `403` — Authenticated user is not allowed to access this resource
- `404` — The resource was not found
- `408` — Request timeout
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.dev/edubank/apis/api-edubank.md) · [All operations](https://skmtc.dev/edubank/apis/api-edubank/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/edubank/api-edubank/revisions/dce4008191d4/schema)