---
title: "Cadastra uma nova conta do parceiro"
method: POST
path: "/v1/partner/accounts"
tags: ["partner"]
---

# Cadastra uma nova conta do parceiro

`POST /v1/partner/accounts`

A API de parceiros é ideal para parcerias de contas guarda-chuva ou [canais*](https://blog.vindi.com.br/programa-de-parcerias/). Com essa integração, nossos parceiros terão autonomia para criar suas próprias contas SaaS e se conectar à subadquirente da Vindi, via API.
Os novos endpoints fazem parte de uma rota de serviços de autoatendimento, permitindo a criação e o credenciamento de subcontas de contas guarda-chuva por meio da API. Com isso, o processo de criação de conta na Vindi Recorrência e na Vindi Pagamentos é automatizado, oferecendo uma experiência mais rápida e eficiente aos nossos parceiros.

Para solicitar as credenciais para utilização, fale com a gente na [central de ajuda](https://atendimento.vindi.com.br/hc/pt-br) ou com o seu gerente de contas para que a integração seja liberada.

Utilize esta função para criar novas contas.

## Request body

- PostV1PartnerAccounts — Cadastra uma nova conta do parceiro
  - `body` Create
    - `name` string, required — Nome fantasia da empresa
    - `company_name` string, required — Razão social da empresa
    - `cpf` string, required — CPF do sócio(a)
    - `cnpj` string, required — CNPJ da empresa
    - `user_name` string, required — Nome completo do sócio(a)
    - `user_email` string, required — E-mail do sócio(a)
    - `economic_activity` string, required — CNAE - Classificação Nacional de Atividades Econômicas da empresa
    - `bank_account` Parameters
      - `bank_code` string, required — Código do banco
      - `bank_branch` string, required — Agência
      - `account_number` string, required — Conta bancária
      - `account_digit` string, required — Dígito da conta bancária
    - `address` AddressParameters, required
      - `street` string, required — Endereço (rua, avenida etc)
      - `number` string, required — Número do endereço
      - `additional_details` string — Complemento do endereço
      - `zipcode` string, required — CEP
      - `neighborhood` string, required — Bairro
      - `city` string, required — Cidade
      - `state` string, required — Estado
      - `country` string, required — Código do país no formato ISO 3166-1 alpha-2. Exemplo: BR
    - `phone_number` string, required — Número de telefone
    - `template_code` string — Código do template de conta, utilizado para que a contaseja criada com as configurações presentes no template.

## Response `201`

Subconta criada com sucesso

- Account — Utilize este método para listar as contas associadas ao parceiro. Leia a documentação sobre [paginação](https://atendimento.vindi.com.br/hc/pt-br/articles/203020644#pagination) e [filtros de busca](https://atendimento.vindi.com.br/hc/pt-br/articles/204163150).
  - `id` integer, required — ID da subconta
  - `user_email` string, required — E-mail da subconta
  - `name` string, required — Nome da subconta
  - `company_name` string, required — Razão social
  - `cnpj` string, required — CNPJ da subconta
  - `status` 'active' | 'inactive' | 'trial', required — Status da subconta
  - `created_at` string, required — Data de criação da subconta
  - `api_key` string

## Other responses

- `400` — Erro de sintaxe JSON no corpo do request.
- `422` — Parâmetros inválidos. Verificar erro na resposta.

---

[API](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost.md) · [All operations](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vindi/001-vindi-pagamentos-agost/revisions/9d11e5de9308/schema)