---
title: "Criar endereço"
method: POST
path: "/customers/{customer_id}/addresses"
---

# Criar endereço

`POST /customers/{customer_id}/addresses`

## Request

- Base URL: `https://api.mundipagg.com/core/v1`
- URL: `https://api.mundipagg.com/core/v1/customers/{customer_id}/addresses`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/mundipagg/apis/mundipagg-api/docs/customers/:customer_id/addresses/post.ts> (a function with typed inputs; its response is checked against the schema)

Para a criação de um `address` é necessário informar o `customer_id` do cliente ao qual será associado o endereço.

## Path parameters

- `customer_id` string, required

## Request body

- object
  - `line_1` string, required: Linha 1 do endereço. (Número, Rua, e Bairro - Nesta ordem e separados por vírgula) Max: 256 caracteres.
  - `line_2` string: Linha 2 do endereço. (Complemento - Andar, Sala, Apto). Max: 128 caracteres.
  - `zip_code` string, required: CEP. Max: 16 caracteres.
  - `city` string, required: Cidade. Max: 64 caracteres.
  - `state` string, required: Código do estado no formato ISO 3166-2. <a href="https://pt.wikipedia.org/wiki/ISO_3166-2" target="_blank">Saiba mais sobre ISO 3166-2</a>
  - `country` string, required: Código do país no formato ISO 3166-1 alpha-2. <a href="https://pt.wikipedia.org/wiki/ISO_3166-1_alfa-2" target="_blank">Saiba mais sobre ISO 3166-1 alpha-2</a>
  - `metadata` object: Objeto chave/valor utilizado para armazenar informações adicionais sobre o endereço. [Saiba mais sobre metadata](https://docs.mundipagg.com/v1/reference#metadata)

## Response `200`

200

- object
  - `id` string
  - `line_1` string
  - `line_2` string
  - `zip_code` string
  - `city` string
  - `state` string
  - `country` string
  - `status` string
  - `created_at` string
  - `updated_at` string
  - `customer` object
    - `id` string
    - `name` string
    - `email` string
    - `document` string
    - `type` string
    - `delinquent` boolean
    - `created_at` string
    - `updated_at` string
    - `metadata` object
      - `id` string
  - `metadata` object
    - `id` string

## Other responses

- `404`: 404
- `422`: 422

---

[API](https://skmtc.dev/mundipagg/apis/mundipagg-api.md) - [All operations](https://skmtc.dev/mundipagg/apis/mundipagg-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mundipagg/apis/mundipagg-api/revisions/1ddb9f03a82d?raw)