# Criar subconta PJ
`POST /v1/proposals`
**Área:** Subcontas ValidaPay

**Scopes necessários:** `proposals/write`

Com esta funcionalidade você pode criar subcontas Pessoa Jurídica na ValidaPay. Ao criar a subconta ela ficará associada à sua conta (chamaremos de conta Master).

Case de uso:

_Como SaaS tenho vários Sellers, preciso gerar cobranças para esses Sellers e receber split em cada venda._

> ⚠️ **Atenção:** Não é possivel criar uma subconta com mesmo email e telefone da _master account_ 
  
> ⚠️ **Atenção:** Dados de renda/faturamento no campo financialDetails são obrigatórios. Os respectivos códigos estão descritos no apêndice Campos Financeiros ao final da sessão Subcontas ValidaPay

### Request body

```json
{
    "contactNumber": "+5511912345678",
    "documentNumber": "99665544000130",
    "businessEmail": "empresa@exemplo.com.br",
    "businessName": "Empresa Exemplo LTDA",
    "tradingName": "Empresa Exemplo",
    "companyType": "PJ",
    "owner": [
        {
            "ownerType": "SOCIO",
            "documentNumber": "22233344405",
            "fullName": "Cesar Lattes ",
            "phoneNumber": "+5511912345128",
            "email": "socio@exemplo.com.br",
            "motherName": "Marie Curie",
            "socialName": "Nome",
            "birthDate": "02-02-1990",
            "address": {
                "postalCode": "06455030",
                "street": "Alameda Xingu",
                "number": "50",
                "addressComplement": "",
                "neighborhood": "Alphaville Industrial",
                "city": "Barueri",
                "state": "SP"
            },
            "isPoliticallyExposedPerson": false,
            "financialOwnerDetails": {
                "ownerDeclaredIncome": "ODIB02", 
                "ownerDeclaredRevenue": "ODRB02" 
              }
        }
    ],
    "businessAddress": {
        "postalCode": "06455030",
        "street": "Alamed Xingu",
        "number": "350",
        "addressComplement": "",
        "neighborhood": "Alphaville Industrial",
        "city": "Barueri",
        "state": "SP"
    },
    "webhookUrl": "https://api.teste.com.br" 
}
```

### Campos do body

**Obrigatórios:** `contactNumber`, `documentNumber`, `businessEmail`, `businessName`, `tradingName`, `companyType`, `ownerType`, `fullName`, `phoneNumber`, `email`, `motherName`, `socialName`, `birthDate`, `postalCode`, `street`, `number`, `addressComplement`, `neighborhood`, `city`, `state`, `isPoliticallyExposedPerson`, `ownerDeclaredIncome`, `ownerDeclaredRevenue`

| Campo | Descrição |
|---|---|
| `contactNumber` | Telefone da empresa |
| `documentNumber` | CPF do sócio |
| `businessEmail` | email da empresa |
| `businessName` | Razão social |
| `tradingName` | Nome fantasia |
| `companyType` | PJ, MEI ou ME |
| `ownerType` |  |
| `fullName` | Nome completo do sócio |
| `phoneNumber` | Telefone celular do sócio |
| `email` | email do sócio |
| `motherName` |  |
| `socialName` |  |
| `birthDate` | Data de nascimento do sócio |
| `postalCode` | CEP da empresa |
| `street` |  |
| `number` |  |
| `addressComplement` |  |
| `neighborhood` |  |
| `city` |  |
| `state` |  |
| `isPoliticallyExposedPerson` |  |
| `ownerDeclaredIncome` | Renda do sócio |
| `ownerDeclaredRevenue` | Faturamento da empresa |

**Opcionais**

| Campo | Descrição |
|---|---|
| `webhookUrl` | URL onde você gostaria de receber a notificação de criação de conta |

### Resposta 201 — 201

```json
{
    "status": "UNFINISHED",
    "message": "Formulário criado com sucesso",
    "formId": "fb8cbb9d-d376-4604-940c-957e76e3dcbb"
}
```

### Resposta 200 — 200

```json
{
    "status": "FINISHED",
    "message": "Formulário criado com sucesso",
    "formId": "8f82a068-ff1a-45b7-8f98-71f07176e0dd"
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/post-criar-subconta-pj
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json