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

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

Com esta funcionalidade você pode criar subcontas Pessoa Física 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
{
    "documentNumber": "11122233396",
    "phoneNumber": "+5511912345678",
    "email": "empresa@exemplo.com.br",
    "motherName": "Teste Mãe",
    "fullName": "Richard Feynman",
    "socialName": "",
    "birthDate": "31-12-2000",
    "address": {
        "postalCode": "06455030",
        "street": "Alameda Xingu",
        "number": "350",
        "addressComplement": "",
        "neighborhood": "Alphaville Industrial",
        "city": "Barueri",
        "state": "SP"
    },
    "isPoliticallyExposedPerson": false,
    "financialDetails": {
        "declaredIncome": "1DINP02", 
        "occupation": "ONP07", 
        "netWorth": "NWNP02" 
    },
    "webhookUrl": "https://api.teste.com.br" 
}
```

### Campos do body

**Obrigatórios:** `documentNumber`, `phoneNumber`, `email`, `motherName`, `fullName`, `birthDate`, `postalCode`, `street`, `number`, `addressComplement`, `neighborhood`, `city`, `state`, `isPoliticallyExposedPerson`, `declaredIncome`, `occupation`, `netWorth`

| Campo | Descrição |
|---|---|
| `documentNumber` | CPF do titular |
| `phoneNumber` | Número de telefone do titular |
| `email` | email do titular |
| `motherName` |  |
| `fullName` | Nome completo do titular |
| `birthDate` | Data de nascimento do titular |
| `postalCode` | CEP do titular |
| `street` |  |
| `number` |  |
| `addressComplement` |  |
| `neighborhood` |  |
| `city` |  |
| `state` |  |
| `isPoliticallyExposedPerson` |  |
| `declaredIncome` | Renda declarada do titular |
| `occupation` | Profissão do titular |
| `netWorth` | Patrimônio do titular |

**Opcionais**

| Campo | Descrição |
|---|---|
| `socialName` |  |
| `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": "a6358673-dd00-4c6d-9592-df393513a78a"
}
```

### Resposta 200 — 200

```json
{
    "status": "FINISHED",
    "message": "Formulário atualizado com sucesso",
    "formId": "cda0e605-44f7-4cbc-850c-ef3a2073c685"
}
```

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