CRM GrapeInstall

Summary

Lists contacts from the CRM Grape account, optionally filtered by a search term, up to a maximum number of results.

Inputs

• Busca (querySearch) — Free-text search matched against contact name, phone or email. Sent as the search query parameter only when non-empty; otherwise no filter is applied.
• Limite (queryLimit) — Maximum number of contacts to return. Defaults to 50. Sent as the limit query parameter.

Output shape

Items built from the JSON response of GET /api/v1/n8n/query/contacts. If the API returns an array, each element becomes an output item; an object becomes a single item. Each output is paired with its input item.

The response field structure is defined by the CRM API and is not visible in the node source. Runs once per input item. Authenticates with the webhook token from the Grape credentials via the X-N8N-Auth header. Errors (401, 403, 400, 404, 500) are thrown with Portuguese messages. If Continue On Fail is enabled, an item with {error: message} is returned instead. No pagination: only the first limit results are fetched.

Examples

Example 1: Find a contact by phone number before creating a ticket

Resource: Consulta, Operation: Listar Contatos, Busca: 5511999999999, Limite: 1

Example 2: Pull a larger list of contacts for export or sync

Resource: Consulta, Operation: Listar Contatos, Busca: empty, Limite: 200

Links

• n8n community nodes installation guide