---
title: "Criar Conta"
method: POST
path: "/marketplace/create_account"
---

# Criar Conta

`POST /marketplace/create_account`

## Request

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

Utilize o `live_api_token` da Conta Mestre.
 
Para planos que têm o recurso Marketplace. Permite a criação de contas bancárias iugu [Para mais informações sobre como configurar um subconta](https://dev.iugu.com/docs/configurar-subconta-por-api).

## Headers

- `Request-Time` string, date-time, required
- `Signature` string, required

## Request body

- object
  - `name` string: Nome da Conta — **Não insira números nem caracteres especiais**.
  - `splits` object[]: Regra de Split que será utilizado para **todas as faturas** criadas por esta conta. <br> Se utilizado [Split por Fatura](https://dev.iugu.com/docs/split-de-pagamentos#split-por-fatura-split-vari%C3%A1vel), esta configuração será desconsiderada.
    - `recipient_account_id` string: ID da conta que receberá o split.
    - `cents` integer: Centavos a serem cobrados.
    - `percent` number, float: Porcentagem do valor **total** da fatura a ser dividido para o `recepient_account_id`.
    - `bank_slip_cents` integer: Valor a ser dividido se a fatura for paga por **Boleto Bancário** — `bank_slip`.
    - `bank_slip_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga por **Boleto Bancário** — `bank_slip`.
    - `credit_card_cents` integer: Valor a ser dividido se a fatura for paga por **Cartão de Crédito** — `credit_card`.
    - `credit_card_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga por **Cartão de Crédito** — `credit_card`.
    - `pix_cents` integer: Valor a ser dividido se a fatura for paga por **PIX** — `pix`.
    - `pix_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga por **PIX** — `pix`.
    - `permit_aggregated` boolean: Se `true`, permite utilizar Splits tanto do tipo `percent` quanto `cents`.
    - `credit_card_1x_cents` integer: Valor a ser dividido se a fatura for paga em `1x` (à vista) no Cartão de Crédito.
    - `credit_card_2x_cents` integer: Valor a ser dividido se a fatura for paga em `2x` no Cartão de Crédito.
    - `credit_card_3x_cents` integer: Valor a ser dividido se a fatura for paga em `3x` no Cartão de Crédito.
    - `credit_card_4x_cents` integer: Valor a ser dividido se a fatura for paga em `4x` no Cartão de Crédito.
    - `credit_card_5x_cents` integer: Valor a ser dividido se a fatura for paga em `5x` no Cartão de Crédito.
    - `credit_card_6x_cents` integer: Valor a ser dividido se a fatura for paga em `6x` no Cartão de Crédito.
    - `credit_card_7x_cents` integer: Valor a ser dividido se a fatura for paga em `7x` no Cartão de Crédito.
    - `credit_card_8x_cents` integer: Valor a ser dividido se a fatura for paga em `8x` no Cartão de Crédito.
    - `credit_card_9x_cents` integer: Valor a ser dividido se a fatura for paga em `9x` no Cartão de Crédito.
    - `credit_card_10x_cents` integer: Valor a ser dividido se a fatura for paga em `10x` no Cartão de Crédito.
    - `credit_card_11x_cents` integer: Valor a ser dividido se a fatura for paga em `11x` no Cartão de Crédito.
    - `credit_card_12x_cents` integer: Valor a ser dividido se a fatura for paga em `12x` no Cartão de Crédito.
    - `credit_card_1x_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga em `1x` (à vista) no Cartão de Crédito.
    - `credit_card_2x_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga em `2x` no Cartão de Crédito.
    - `credit_card_3x_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga em `3x` no Cartão de Crédito.
    - `credit_card_4x_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga em `4x` no Cartão de Crédito.
    - `credit_card_5x_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga em `5x` no Cartão de Crédito.
    - `credit_card_6x_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga em `6x` no Cartão de Crédito.
    - `credit_card_7x_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga em `7x` no Cartão de Crédito.
    - `credit_card_8x_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga em `8x` no Cartão de Crédito.
    - `credit_card_9x_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga em `9x` no Cartão de Crédito.
    - `credit_card_10x_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga em `10x` no Cartão de Crédito.
    - `credit_card_11x_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga em `11x` no Cartão de Crédito.
    - `credit_card_12x_percent` number, float: Percentual do valor total da fatura a ser dividido se for paga em `12x` no Cartão de Crédito.

## Response `200`

200

- object
  - `account_id` string
  - `name` string
  - `live_api_token` string
  - `test_api_token` string
  - `user_token` string

## Other responses

- `400`: 400

---

[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)