---
title: "Criar Plano"
method: POST
path: "/plans"
---

# Criar Plano

`POST /plans`

## Request

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

Cria um plano.

## Request body

- object
  - `name` string, required: Nome do plano
  - `identifier` string, required: Identificador do plano
  - `interval` integer, required: Ciclo do plano (Entre 1 e 599). Intervalo até a próxima cobrança.
  - `interval_type` string, required: Tipo de interval ("weeks" ou "months").
  - `value_cents` integer, required: Preço do plano em centavos
  - `payable_with` string[]: Método de pagamento que será disponibilizado para as faturas pertencentes a assinaturas deste plano ('all', 'credit_card', 'bank_slip' ou 'pix')
  - `features` object[]
    - `name` string, required: Nome da funcionalidade
    - `identifier` string, required: Identificador único da funcionalidade
    - `value` integer, required: Valor da funcionalidade (número maior que 0)
  - `billing_days` integer: Dias de faturamento (Quantos dias antes de vencer a assinatura será gerada uma nova fatura)
  - `max_cycles` integer: Limite de ciclos da assinatura - 0 para indeterminado
  - `invoice_max_installments` integer: Envie um valor de '1' à '12'. Se este parâmetro não for enviado, a quantidade máxima de parcelas será o que está configurado na conta.

## Response `200`

200

- object
  - `id` string
  - `name` string
  - `identifier` string
  - `interval` integer
  - `interval_type` string
  - `created_at` string
  - `updated_at` string
  - `prices` object[]
    - `id` string
    - `currency` string
    - `value_cents` integer
    - `plan_id` string
    - `created_at` string
    - `updated_at` string
  - `features` object[]
    - `id` string
    - `name` string
    - `identifier` string
    - `value` integer
    - `important` unknown
    - `plan_id` string
    - `position` integer
    - `created_at` string
    - `updated_at` string
  - `payable_with` string[]
  - `max_cycles` integer
  - `billing_days` integer
  - `invoice_max_installments` unknown

## Other responses

- `400`: 400

---

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