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

# Criar sócio - PJ

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

## Request

- Base URL: `https://pagamentos.grafeno.be/api/v2`
- URL: `https://pagamentos.grafeno.be/api/v2/clients/{onboarding_id}/partners/companies`
- Auth: HTTP basic and API key in header `Authorization`
- TypeScript: <https://skmtc.dev/grafeno/apis/api-v2-grafeno/docs/clients/:onboarding_id/partners/companies/post.ts> (a function with typed inputs; its response is checked against the schema)

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