Mudar o nome

Só o nome muda. O documento é a identidade do empregador: para outro CNPJ, cadastre outro empregador.

PUT https://integration.enviaesocial.com.br/v1/employers/{uuid}

Autenticação Bearer es_…

Corpo application/json

Sucesso 200 employer_updated

Caminho

uuid uuid

obrigatório

O uuid do empregador.

Corpo

name texto

obrigatório

O novo nome, até 150 caracteres.

Respostas

200 employer_updated

Nome trocado. A resposta traz o empregador.

422 validation_error

Nome vazio ou com mais de 150 caracteres.

404 not_found

Não existe nesta empresa.

401 invalid_api_key

Chave ausente, inválida ou revogada.

Mudar o nome

PUT /v1/employers/{uuid}

Você envia

application/json

curl -X PUT "https://integration.enviaesocial.com.br/v1/employers/{uuid}" \  -H "Authorization: Bearer $ENVIAESOCIAL_KEY" \  -H "Content-Type: application/json" \  -d '{    "name": "Padaria e Confeitaria Pão Dourado Ltda"  }'

$http = new GuzzleHttp\Client([    'base_uri' => 'https://integration.enviaesocial.com.br/v1/',    'headers'  => ['Authorization' => 'Bearer ' . getenv('ENVIAESOCIAL_KEY')],]); $response = $http->put('employers/{uuid}', ['json' => [    'name' => 'Padaria e Confeitaria Pão Dourado Ltda',]]); $result = json_decode($response->getBody(), true);

const res = await fetch('https://integration.enviaesocial.com.br/v1/employers/{uuid}', {  method: 'PUT',  headers: { Authorization: `Bearer ${process.env.ENVIAESOCIAL_KEY}`, 'Content-Type': 'application/json' },  body: JSON.stringify({    name: "Padaria e Confeitaria Pão Dourado Ltda",  }),});const { data } = await res.json();

import osimport requests auth = {"Authorization": f"Bearer {os.environ['ENVIAESOCIAL_KEY']}"} res = requests.put(    "https://integration.enviaesocial.com.br/v1/employers/{uuid}",    headers=auth,    json={        "name": "Padaria e Confeitaria Pão Dourado Ltda",    },)data = res.json()["data"]

using System.Text; using var http = new HttpClient { BaseAddress = new Uri("https://integration.enviaesocial.com.br/v1/") };http.DefaultRequestHeaders.Authorization =    new("Bearer", Environment.GetEnvironmentVariable("ENVIAESOCIAL_KEY")); var body = """{  "name": "Padaria e Confeitaria Pão Dourado Ltda"}"""; var res = await http.PutAsync("employers/{uuid}",    new StringContent(body, Encoding.UTF8, "application/json"));var json = await res.Content.ReadAsStringAsync();

Você recebe

employer_updated · Nome trocado. A resposta traz o empregador.

validation_error · Nome vazio ou com mais de 150 caracteres.

not_found · Não existe nesta empresa.

invalid_api_key · Chave ausente, inválida ou revogada.

{  "status": "success",  "message": "employer_updated",  "data": {    "employer": {      "uuid": "a81d3e5c-0f2b-4c69-9d17-5e6b4a2c8f03",      "document_type": "CNPJ",      "document": "11222333000181",      "name": "Padaria e Confeitaria Pão Dourado Ltda",      "link_type": "PROXY",      "certificate": {        "uuid": "3f2b9c1e-6a47-4d0b-8e15-2c9a7f3b1d60",        "holder": {          "name": "CONTABIL HORIZONTE LTDA",          "document": "11222444000198",          "document_type": "CNPJ"        },        "valid_until": "2027-08-14T10:22:31-03:00"      },      "created_at": "2026-10-17T14:20:05-03:00",      "updated_at": "2026-10-17T15:02:44-03:00"    }  }}

{  "status": "error",  "message": "validation_error",  "data": {    "errors": [      {        "field": "name",        "code": "require",        "detail": "Informe o nome."      }    ]  }}

{  "status": "error",  "message": "not_found",  "data": {    "errors": [      {        "field": null,        "code": "not_found",        "detail": "Empregador não encontrado."      }    ]  }}

{  "status": "error",  "message": "invalid_api_key",  "data": {    "errors": [      {        "field": null,        "code": "invalid_api_key",        "detail": "Chave de API ausente, inválida ou revogada."      }    ]  }}

integration.enviaesocial.com.br/v1