---
title: "Criar Autorização Pix Automatico"
method: POST
path: "/automatic_pix/recurrences"
---

# Criar Autorização Pix Automatico

`POST /automatic_pix/recurrences`

## Request

- Base URL: `https://api.iugu.com/v1`
- URL: `https://api.iugu.com/v1/automatic_pix/recurrences`
- Auth: API key in query parameter `api_token`

Cria uma recorrência (autorização de Pix Automático). Orquestrada por `Cmd::AutomaticPix::RecurrenceCreator`.

## Request body

- object
  - `recurrence_id` string, required: Identificador da recorrência.
  - `frequency` string, required: Frequência da recorrência.
  - `recurrence_beginning` string, required: Início da recorrência.
  - `recurrence_end` string: Fim da recorrência.
  - `value` string: Valor fixo. Ausente no caso padrão (valor variável, com piso/teto) — JDPI 4.2.8/4.3.3 tratam valor fixo e variável como tipos mutuamente exclusivos.
  - `contract_number` string, required: Número do contrato.
  - `contract_description` string, required: Descrição do contrato.
  - `recurrence_created_at` string: Data de criação da recorrência.
  - `recurrence_authorized_at` string: Data de autorização da recorrência.
  - `journey` string, required: Jornada do Pix Automático.
  - `receiver` object: Dados do recebedor.
    - `receiver.receiver_ispb` string, required: ISPB do recebedor.
    - `receiver.receiver_document` string, required: Documento do recebedor.
    - `receiver.receiver_name` string, required: Nome do recebedor.
  - `payer` object: Dados do pagador.
    - `payer.payer_type` integer, required: Tipo do documento do pagador (0 = CPF, 1 = CNPJ).
    - `payer.payer_document` string, required: Documento do pagador.
    - `payer.payer_name` string, required: Nome do pagador.

## Response `200`

---

[API](https://skmtc.dev/iugu/apis/baas.md) - [All operations](https://skmtc.dev/iugu/apis/baas/llms.txt) - [OpenAPI document](https://skmtc.dev/iugu/apis/baas/revisions/36bf4590d03a?raw)