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

# Criar Subconta

`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`

Permite a criação de subcontas (contas de pagamento) para contas com permissão de Marketplace ou parceiro de negócios. [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
- `X-Signature-Token-Id` string

## Request body

- object
  - `name` string: Nome da subconta, não deverá conter números ou caracteres especiais. Se não enviado, o ID da conta é utilizado por padrão.
  - `splits` object[]: Lista de splits que será utilizado nesse conta.
    - `recipient_account_id` string: ID Da conta que irá receber o split
    - `cents` integer: Centavos a serem cobrados.
    - `percent` number, float: Porcentagem a ser cobrada.
    - `bank_slip_cents` integer: Valor em centavos a ser cobrado apenas em transações no boleto.
    - `bank_slip_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações no boleto.
    - `credit_card_cents` integer: Valor em centavos a ser cobrado apenas em transações no cartão de crédito.
    - `credit_card_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações no cartão de crédito.
    - `pix_cents` integer: Valor em centavos a ser cobrado apenas em transações no pix.
    - `pix_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações no pix.
    - `permit_aggregated` boolean: Permite agregar comissionamento percentual + fixo.
    - `credit_card_1x_cents` integer: Valor em centavos a ser cobrado apenas em transações em 1x no cartão de crédito.
    - `credit_card_2x_cents` integer: Valor em centavos a ser cobrado apenas em transações em 2x no cartão de crédito.
    - `credit_card_3x_cents` integer: Valor em centavos a ser cobrado apenas em transações em 3x no cartão de crédito.
    - `credit_card_4x_cents` integer: Valor em centavos a ser cobrado apenas em transações em 4x no cartão de crédito.
    - `credit_card_5x_cents` integer: Valor em centavos a ser cobrado apenas em transações em 5x no cartão de crédito.
    - `credit_card_6x_cents` integer: Valor em centavos a ser cobrado apenas em transações em 6x no cartão de crédito.
    - `credit_card_7x_cents` integer: Valor em centavos a ser cobrado apenas em transações em 7x no cartão de crédito.
    - `credit_card_8x_cents` integer: Valor em centavos a ser cobrado apenas em transações em 8x no cartão de crédito.
    - `credit_card_9x_cents` integer: Valor em centavos a ser cobrado apenas em transações em 9x no cartão de crédito.
    - `credit_card_10x_cents` integer: Valor em centavos a ser cobrado apenas em transações em 10x no cartão de crédito.
    - `credit_card_11x_cents` integer: Valor em centavos a ser cobrado apenas em transações em 11x no cartão de crédito.
    - `credit_card_12x_cents` integer: Valor em centavos a ser cobrado apenas em transações em 12x no cartão de crédito.
    - `credit_card_1x_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações em 1x no cartão de crédito.
    - `credit_card_2x_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações em 2x no cartão de crédito.
    - `credit_card_3x_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações em 3x no cartão de crédito.
    - `credit_card_4x_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações em 4x no cartão de crédito.
    - `credit_card_5x_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações em 5x no cartão de crédito.
    - `credit_card_6x_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações em 6x no cartão de crédito.
    - `credit_card_7x_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações em 7x no cartão de crédito.
    - `credit_card_8x_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações em 8x no cartão de crédito.
    - `credit_card_9x_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações em 9x no cartão de crédito.
    - `credit_card_10x_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações em 10x no cartão de crédito.
    - `credit_card_11x_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações em 11x no cartão de crédito.
    - `credit_card_12x_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações 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/conta-de-pagamento-e-marketplace.md) - [All operations](https://skmtc.dev/iugu/apis/conta-de-pagamento-e-marketplace/llms.txt) - [OpenAPI document](https://skmtc.dev/iugu/apis/conta-de-pagamento-e-marketplace/revisions/ac63d9cc52eb?raw)