AgendorInstall

Summary

Search for companies (Empresas) in Agendor CRM by a specific ID, by CNPJ, or list multiple companies with optional pagination and custom fields inclusion.

Inputs

• Tipo de Busca (required) — Choose whether to search a company by its unique ID, by its CNPJ number, or to list all companies.
• ID da Empresa (required) — The unique identifier of the company in Agendor, required when searching by ID.
• CNPJ (required) — The company's CNPJ number (only numeric characters), required when searching by CNPJ.
• Incluir Campos Customizados — Optionally include custom fields associated with the companies in the returned data.
• Retornar Todos — When listing all companies, decide whether to return all available results or limit the number returned.
• Limite — If not returning all companies, set the maximum number of companies to return (between 1 and 100).

Output shape

a single company record when searching by ID or CNPJ, or a list of company records when listing all

If 'Listar Todos' with 'Retornar Todos' set to true, this operation will retrieve all matching companies by automatically paginating through results; otherwise, it returns up to the specified limit. The response may optionally include custom fields if requested. Errors are returned as standard n8n error objects.

Examples

Example 1: Buscar uma empresa pelo ID

Set Tipo de Busca to 'Por ID' and provide the 'ID da Empresa'. The node returns the company details as a single record.

Example 2: Buscar uma empresa pelo CNPJ

Set Tipo de Busca to 'Por CNPJ', enter the CNPJ number, and optionally enable 'Incluir Campos Customizados'. The node returns matching company data.

Example 3: Listar todas as empresas

Set Tipo de Busca to 'Listar Todos'. Choose 'Retornar Todos' to fetch all companies or set 'Limite' to limit results. The node returns a list of companies.