Ploomes CRMInstall

Summary

Retrieve user profile records from Ploomes CRM’s /Users@Profiles endpoint with optional OData filtering, field selection, sorting, and relation expansion. By default, request one record with only its Id, sorted by Id.

Inputs

• cacheStrategy — Choose disabled (default), cacheFirst, or fallbackOnly. Cache First uses a valid cached response before requesting the API; both enabled strategies can return cached data if the request fails.
• cacheTtl — Cache validity in seconds when caching is enabled; defaults to 300. Responses are cached in memory while n8n runs.
• top — Maximum records to request via $top; defaults to 1.
• skip — Records to skip for manual pagination; defaults to 0.
• select — Comma-separated fields to return; defaults to Id. Leave empty to omit $select.
• orderby — OData sort expression, optionally including asc or desc; defaults to Id. Leave empty to omit $orderby.
• useFilterBuilder — Use visual filter collections (default true), or disable to supply a raw OData filter.
• filterRaw — Optional raw $filter expression, used only when the filter builder is disabled.
• filterConditions — Optional field comparisons or contains/startswith/endswith conditions with values, value types, and AND/OR connectors. Auto typing leaves unsigned numeric values unquoted and quotes other values.
• customPropertyFilters — Optional OtherProperties/any filters specifying field ID, value property, comparison operator, value, and whether to leave it unquoted. Joined with AND and appended to the main filter when the builder is enabled.
• collectionFilters — Optional navigation filters specifying collection-any or direct navigation, property, field, operator, value, and AND/OR connectors. Numeric values are detected automatically; the resulting expression is appended with AND when the builder is enabled.
• useExpandBuilder — Use visual relation expansions (default true), or disable to supply a raw OData expansion.
• expandRaw — Optional raw $expand expression, used only when the expand builder is disabled.
• expandRelations — Optional navigation properties to expand, each with optional nested field selection, an enabled raw nested filter, and an enabled nested expansion.
• expandNestedFilters — Optional comparisons grouped by a matching property in Expand Relations, with numeric flags and AND/OR connectors. Combined with that expansion’s raw nested filter using AND.

Output shape

Three outputs: Success contains one n8n JSON item per returned user profile; Error and Timeout contain error records.

Makes one request per incoming item and does not automatically fetch additional pages; use top and skip for pagination. An API value array is flattened into individual items, and an empty array produces no items. Other response bodies are returned as a single item; an empty body produces success metadata. Cached items include _fromCache: true, and cache fallbacks also include _fallback: true. Error records contain error, statusCode, isTimeout, resource, operation, and timestamp. HTTP 408/504 errors go to Timeout; other errors stop execution unless Continue On Fail is enabled.

Links

• n8n community nodes installation guide