---
title: "Criar um novo plano"
method: POST
path: "/v2/plans"
---

# Criar um novo plano

`POST /v2/plans`

Cria um novo plano de assinatura

## Headers

- `X-Token-Api` string, required
- `Content-Type` 'application/json', required

## Request body

- PlanRequest
  - `title` string, required — Título do plano
  - `description` string — Descrição do plano (opcional)
  - `active` boolean — Se o plano está ativo (opcional, padrão: false)
  - `bullets` PlanBullet[] — Lista de benefícios do plano (opcional)
    - `title` string — Título do benefício (opcional)
    - `description` string, required — Descrição do benefício
  - `values` PlanValue[] — Valores e tipos de cobrança do plano (opcional)
    - `type` 'MONTHLY' | 'YEARLY' | 'SEMESTER', required — Tipo de cobrança do plano
    - `value` number, double — Valor total do período (calculado automaticamente)
    - `valuePerMonth` number, double, required — Valor mensal equivalente
  - `acceptPaymentMethods` string[] — Métodos de pagamento aceitos (opcional)

## Response `200`

Plano criado com sucesso

- PlanResponse
  - `uuid` string, uuid, required — UUID único do plano
  - `title` string, required — Título do plano
  - `description` string, required — Descrição do plano
  - `active` boolean, required — Se o plano está ativo
  - `bullets` PlanBullet[] — Lista de benefícios do plano
    - `title` string — Título do benefício (opcional)
    - `description` string, required — Descrição do benefício
  - `values` PlanValue[], required — Valores e tipos de cobrança do plano
    - `type` 'MONTHLY' | 'YEARLY' | 'SEMESTER', required — Tipo de cobrança do plano
    - `value` number, double — Valor total do período (calculado automaticamente)
    - `valuePerMonth` number, double, required — Valor mensal equivalente
  - `acceptPaymentMethods` string[], required — Métodos de pagamento aceitos

## Other responses

- `400` — Dados inválidos fornecidos
- `401` — Token de API inválido ou ausente
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada.md) · [All operations](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/barte/api-de-sellers-v2-atualizada/versions/f0dd55b167f1/schema)