---
title: "Criar sócio - PJ"
method: POST
path: "/clients/{onboarding_id}/partners/companies"
---

# Criar sócio - PJ

`POST /clients/{onboarding_id}/partners/companies`

Cria um novo sócio do tipo de Pessoa Jurídica (PJ) para o processo de onboarding.

## Path parameters

- `onboarding_id` string, required

## Request body

- object
  - `name` string, required — Nome fantasia da empresa.
  - `companyName` string, required — Razão social da empresa.
  - `legalNature` 'LTDA' | 'EIRELI' | 'ME' | 'Associação' | 'Cooperativa' | 'MEI' | 'SA' | 'Outros', required — Natureza legal da empresa.
  - `companyPhone` string, required — Telefone comercial da empresa.
  - `email` string, required — E-Mail da empresa.
  - `nire` string — Nire da empresa.
  - `documentNumber` string, required — CNPJ da empresa.
  - `address` object, required — Endereço da empresa.
    - `street` string, required — Rua do endereço da empresa.
    - `number` string, required — Número do endereço da empresa.
    - `complement` string — Complemento do endereço da empresa.
    - `neighborhood` string, required — Bairro do endereço da empresa.
    - `city` string, required — Cidade do endereço da empresa.
    - `state` string, required — Estado do endereço da empresa.
    - `country` string, required — País do endereço da empresa. (código ALPHA-02).
    - `zipCode` string, required — CEP do endereço da empresa.
    - `proof` object — Comprovante de endereço.
      - `filename` string, required — Nome do arquivo (com extensão).
      - `content` string, required — Conteúdo do arquivo em Base64.
  - `articleOfAssociation` object, required — Contrato social ou estatuto social.
    - `filename` string, required — Nome do arquivo.
    - `content` string, required — Conteúdo do arquivo em Base64.
  - `extraAttachments` object[] — Documentos comprobatórios extras.
    - `filename` string, required — Nome do arquivo (com extensão).
    - `content` string, required — Conteúdo do arquivo em Base64.
  - `parentCompanyId` string — ID da empresa mãe. Se for preenchido com "0", a empresa principal será considerada como a empresa pai deste sócio PJ.
  - `shareCapital` number, double, required — Total de quotas de participação na empresa.
  - `sharePercent` string, required — Percentual de participação na empresa.
  - `agent` object — Informações do preposto.
    - `informed` boolean — Indica se o preposto foi informado.
    - `name` string — Nome completo da pessoa informada como preposto.
    - `documentNumber` string — CPF da pessoa informada como preposto.

## Response `200`

200

- object
  - `data` object
    - `id` string
    - `type` string
    - `attributes` object
      - `documentNumber` string
      - `parentCompanyId` string
      - `legalNature` string
      - `nire` string
      - `name` string
      - `companyName` string
      - `email` string
      - `companyPhone` string
      - `shareCapital` string
      - `sharePercent` string
      - `createdAt` string
      - `updatedAt` string
      - `articleOfAssociation` object
        - `data` object
          - `id` string
          - `type` string
          - `attributes` object
            - `filename` string
            - `content` string
      - `extraAttachments` unknown
      - `agent` object
        - `data` unknown
      - `address` object
        - `data` object
          - `id` unknown
          - `type` string
          - `attributes` object
            - `zipCode` string
            - `street` string
            - `number` string
            - `complement` string
            - `country` string
            - `state` string
            - `city` string
            - `neighborhood` string

## Other responses

- `422` — 422

---

[API](https://skmtc.net/grafeno/apis/api-v2-grafeno.md) · [All operations](https://skmtc.net/grafeno/apis/api-v2-grafeno/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grafeno/api-v2-grafeno/revisions/20f928f6933f/schema)