Register Legal Person

Register Legal Person

POST {{Environment_URL}}/customers/v1/partner/legal

Body Params

Key	Description	Required	Data Type	Example
name	Legal entity name (minimum 3 characters, only letters and spaces)	true	String	EMPRESA BRASILEIRA DE TECNOLOGIA LTDA
cnpj	CNPJ in format 00.000.000/0000-00	true	String	12.345.678/0001-99
nickname	Trade name or alias	true	String	EBTech
email	Email address	true	String	[email protected]
revenue	Annual revenue in BRL	true	Number	1500000.50
mobile	Mobile phone number	true	String	[phone]
addresses	List of addresses related to the company	true	Array of objects	See addresses table below

---

addresses object:

Key	Description	Required	Data Type	Example
nickname	Address nickname	true	String	Matriz São Paulo
street	Street name (min. 5 characters)	true	String	Av. Paulista
number	Street number	true	Number	1578
complement	Additional address info (e.g., apt, suite)	false	String	10 andar
neighborhood	Neighborhood name	true	String	Bela Vista
city	City name	true	String	São Paulo
state	State abbreviation (e.g., RJ, SP)	true	String	SP
zipCode	Postal code	true	String	01310-200
country	Country name	false	String	Brasil
default	Marks this address as the default	true	Boolean	true

Headers

Name	Value
Authorization	Bearer <token>

Request Body

Register Legal Person

{
  "name": "Witting and Sons",
  "cnpj": "87.855.316/0001-43",
  "nickname": "LLC",
  "email": "[email protected]",
  "revenue": 1500000,
  "mobile": "[phone]",
  "addresses": [
    {
      "nickname": "Matriz",
      "street": "Avenida Paulista",
      "number": 1000,
      "complement": "Conjunto 101",
      "neighborhood": "Bela Vista",
      "city": "São Paulo",
      "state": "SP",
      "zipCode": "01310-100",
      "country": "Brasil",
      "default": true
    },
    {
      "nickname": "Filial Rio",
      "street": "Rua das Laranjeiras",
      "number": 250,
      "complement": "Sala 202",
      "neighborhood": "Laranjeiras",
      "city": "Rio de Janeiro",
      "state": "RJ",
      "zipCode": "22240-003",
      "country": "Brasil",
      "default": false
    }
  ]
}

Response

201 - Success

{
  "cnpj": "11.222.333/0001-44",
  "changeSync": false,
  "revenue": 1500000,
  "id": "68b98c8218770542486dcf79",
  "name": "Crona - Ortiz",
  "nickname": "Inc",
  "email": "[email protected]",
  "mobile": "[phone]",
  "status": "pending",
  "documents": [
    {
      "id": "68b98c8218770542486dcf7c",
      "documentType": "CNPJ",
      "versions": [
        {
          "id": "68b98c8218770542486dcf7d",
          "files": [],
          "approved": null,
          "createdAt": "2025-09-04T12:56:13.386Z"
        }
      ]
    }
  ],
  "addresses": [
    {
      "id": "68b98c8218770542486dcf7a",
      "country": "Brasil",
      "state": "SP",
      "city": "West Brittanymouth",
      "neighborhood": "Bela Vista",
      "street": "Mraz Glens",
      "number": 1000,
      "complement": "Conjunto 101",
      "zipCode": "01310-100",
      "default": true,
      "nickname": "Matriz",
      "fullAddress": "62551 D'Amore Burg"
    }
  ],
  "billingAddresses": [],
  "accounts": [],
  "beneficiaries": [],
  "wlCorrespondents": [
    163
  ],
  "verified": {
    "email": false,
    "mobile": false,
    "address": false
  },
  "createdAt": "2025-09-04T12:56:34.378Z",
  "updatedAt": "2025-09-04T12:56:34.378Z",
  "pendencies": [
    "email_confirmation"
  ],
  "limitHistory": [],
  "operationCount": 0
}

400 - Bad Request