---
title: "Criar location do payload."
method: POST
path: "/loc"
tags: ["PayloadLocation"]
---

# Criar location do payload.

`POST /loc`

Criar location do payload

## Request body

- PayloadLocationSolicitada — Identificador da localização do payload solicitada.
  - `tipoCob` 'cob' | 'cobv', required

## Response `201`

Dados da location do Payload.

- PayloadLocation — Identificador da localização do payload.
  - `id` integer, required — Identificador da location a ser informada na criação da cobrança .
  - `location` string, uri, required — Localização do Payload a ser informada na criação da cobrança.
  - `tipoCob` 'cob' | 'cobv', required
  - `criacao` string, date-time, required — Data e hora em que a location foi criada. Respeita RFC 3339.

## Other responses

- `400` — Requisição com formato inválido.
- `403` — Requisição de participante autenticado que viola alguma regra de autorização.
- `503` — Serviço não está disponível no momento. Serviço solicitado pode estar em manutenção ou fora da janela de funcionamento.

## Changes

- **2021-02-10** `3872a6881bfb` — 1 breaking
  - the `id` response's property format changed from `int32` to `int64` for status `201`
- **2020-12-03** `1ab8ae73a0ae` — 3 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `403`
  - added the non-success response with the status `503`
- **2020-11-06** `f4a2162d6068` — 1 breaking, 1 info
  - added required request body
  - added the required property `tipoCob` to the response with the `201` status
- **2020-10-21** `f669c19a8e32` — 1 warning
  - removed the optional property `txid` from the response with the `201` status
- **2020-10-20** `c4a10eca5a89` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/bacen/apis/api-pix/changes/loc/post.md)

---

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