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

## Request

- Base URL: `//app.vindi.com.br/api` (relative, and the document’s source URL is not known)
- URL: `//app.vindi.com.br/api/v1/partner/accounts`
- Auth: HTTP basic

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.dev/vindi/apis/api-vindi.md) - [All operations](https://skmtc.dev/vindi/apis/api-vindi/llms.txt) - [OpenAPI document](https://skmtc.dev/vindi/apis/api-vindi/revisions/3e857e1cdd03?raw)