Como usar a API Econodata no n8n

Este guia mostra como configurar e usar os endpoints da API Econodata v3 dentro do n8n (workflows).

1. Informações gerais

Base URL: https://api.econodata.com.br/ecdt-api
Autenticação: cabeçalho x-api-token (token de integração) ou x-ecdt-token (JWT), conforme o endpoint.
O token de integração é obtido em Integrações na plataforma Econodata (cadastro de novo token). 2. Configurar o token no n8n 1. No n8n, vá em Credentials (menu ou ícone de chave) e crie uma nova credencial.

2. Configurar o token no n8n

No n8n, vá em **Credentials **(menu ou ícone de chave) e crie uma nova credencial.
Escolha o tipo Header Auth (ou "HTTP Header Auth" / similar, dependendo da versão do n8n).
Configure:

Name: Econodata API Token (ou outro nome).

Header Name: x-api-token

Header Value: cole o seu token de integração da Econodata.

Salve a credencial

Dica: para endpoints que usam x-ecdt-token , crie outra credencial Header Auth com Header Name = x-ecdt-token e o valor do JWT.

3. Usar a API nos workflows

Em todos os casos você usa o node HTTP Request (ou "Webhook" só quando for receber chamadas da Econodata).

Adicione um node HTTP Request ao workflow.
Em Method, escolha GET, POST ou PUT conforme a tabela abaixo.
Em URL, use: https://api.econodata.com.br/ecdt-api + o path do endpoint (ex.: /v3/companies/search?cnpj=00.000.000/0000-00 ).
Em Authentication, selecione a credencial de Header Auth que você criou ( x-api-token ou x-ecdttoken ).
Para POST/PUT: em Body Content Type = JSON e em **Body **preencha o JSON indicado em cada exemplo.

4. Endpoints e como configurar no HTTP Request

4.1 Empresas — POST /v3/companies

Consultar várias empresas por lista de CNPJs.

Campo no n8n	Valor
Method	POST
URL	https://api.econodata.com.br/ecdt-api/v3/companies
Auth	Header Auth (x-api-token)
Body (JSON)	["17.948.237/0001-00", "00.000.000/0001-91"]

Resposta: objeto com empresas e erros.

4.2 Empresas — GET /v3/companies/search

Buscar uma empresa por CNPJ, site, e-mail ou raiz do CNPJ (parâmetros na URL).

Campo no n8n	Valo
Method	GET
URL (exemplo por CNPJ)	https://api.econodata.com.br/ecdt-api/v3/companies/search?
Auth	Header Auth (x-api-token)

Outros parâmetros: ?site=exemplo.com.br , ?email=contato@empresa.com.br , ?raiz_cnpj=00.000.000 .

4.3 Empresas — POST /v3/companies/search

Mesma busca, com critérios no body.

Campo no n8n	Valor
Method	POST
URL	https://api.econodata.com.br/ecdt-api/v3/companies/search
Body (JSON)	{"cnpj": "00.000.000/0000-00"} ou {"site": "exemplo.com.br"}

4.4 Token — GET /v3/valid-token-integration

Validar se o token está ativo e obter dados da integração

Campo no n8n	Valor
Method	GET
URL	https://api.econodata.com.br/ecdt-api/v3/valid-token-integration
Auth	Header Auth (x-api-token)

4.5 Informação webhook — GET /v3/webhook

Obter dados do webhook associado ao token (nome, URL, ativo).

Campo no n8n	Valor
Method	GET
URL	https://api.econodata.com.br/ecdt-api/v3/webhook
Auth	Header Auth (x-api-token)

4.6 Webhooks — GET /v3/webhooks

Listar todos os webhooks da conta (requer token JWT da plataforma).

Campo no n8n	Valor
Method	GET
URL	https://api.econodata.com.br/ecdt-api/v3/webhooks
Auth	Header Auth (x-ecdt-token)

4.7 Webhooks — POST /v3/webhooks

Cadastrar novo webhook.

Campo no n8n	Valor
Method	POST
URL	https://api.econodata.com.br/ecdt-api/v3/webhooks
Auth	Header Auth (x-ecdt-token)
Body (JSON)	{"nomeIntegracao": "Minha integração", "webhookUrl": "https://meuwebhook.com/receber"}

4.8 Webhooks — PUT /v3/webhooks

Atualizar URL, nome ou status (ativo) do webhook.

Campo no n8n	Valor
Method	PUT
URL	https://api.econodata.com.br/ecdt-api/v3/webhooks
Auth	Header Auth (x-api-token do webhook)
Body (JSON)	{"urlWebhook": "https://nova-url.com", "nomeIntegracao": "Nome", "ativo": true}

4.9 Tags — POST /v3/update-lead

Adicionar tags às empresas.

Campo no n8n	Valor
Method	POST
URL	https://api.econodata.com.br/ecdt-api/v3/update-lead
Auth	Header Auth (x-api-token)
Body (JSON)	{"empresas": [{"cnpj": "00.000.000/0000-00"}], "tags": ["tag1", "tag2"]}

5. Respostas de erro

A API retorna JSON no formato:

{"error": {"code": 400, "message": "Mensagem explicativa."}}

Códigos comuns: 400 (inválido), 401 (token ausente/inválido), 404 (não encontrado), 429 (limite de requisições). No n8n você pode tratar o status code e o body no node seguinte (IF, Code, etc.).

6. Resumo rápido

Método	Endpoint	Header
POST	/v3/companies	x-api-token
GET	/v3/companies/search	x-api-token
POST	/v3/companies/search	x-api-token
GET	/v3/valid-token-integration	x-api-token
GET	/v3/webhook	x-api-token
GET	/v3/webhooks	x-ecdt-token
POST	/v3/webhooks	x-ecdt-token
PUT	/v3/webhooks	x-api-token
POST	/v3/update-lead	x-api-token

Documentação API Econodata v3 — Uso no n8n. Base URL: https://app.swaggerhub.com/apis-docs/econodata-ab7/econodata-api/3.0.0#/Empresas/getCompanyByParametersQueryV3

Se você quer aperfeiçoar o uso da Econodata, entre em contato com o suporte no email "suporte@econodata.com.br".

Actualizado em: 19/03/2026

Esse artigo foi útil?

Obrigado!