Actions36
- Activity Actions
- Contact Actions
- Customer Actions
- Data Proxy Actions
- Document Actions
- Employer Actions
- Lead Actions
- Meeting Actions
- Meeting Summary Actions
- Report Actions
- Workflow Actions
Employer → Search Employers
AI-generatedOverview
The node named "Surense" provides integration with the Surense API, allowing users to interact with various resources such as Employers, Customers, Contacts, Leads, and more. Specifically, for the Employer resource with the Search Employers operation, the node enables searching and retrieving a list of employers based on sorting, pagination, and optional quick search filters.
This node is beneficial in scenarios where you need to automate workflows involving employer data retrieval from Surense, such as syncing employer records, generating reports, or filtering employers dynamically within an automation pipeline.
Practical Example
- Retrieve a paginated list of employers sorted by creation date in descending order.
- Search employers quickly by name, ID, email, or phone using the quick filter parameter.
- Use the limit and page parameters to control the number of results and navigate through pages of employer data.
Properties
| Name | Meaning |
|---|---|
| Order | Sort order of the results. Options: עולה (ascending), יורד (descending). |
| Order By | Field to sort the results by. Options: תאריך יצירה (createdDate), תאריך עדכון אחרון (lastActivityDate). |
| Limit | Maximum number of results to return. Minimum value is 1. |
| Page | Page number for pagination. Minimum value is 1. |
| Additional Parameters | Collection of extra parameters. Includes: |
| - חיפוש מהיר (quickFilter) | Quick search term that can match name, ID, email, or phone. |
Output
The node outputs JSON data containing the search results for employers. Each item in the output corresponds to an employer record matching the search criteria, including fields returned by the Surense API for employers.
If binary data were involved, it would be summarized here, but this operation focuses on JSON data output only.
Dependencies
- Requires an active connection to the Surense API via an OAuth2 API credential.
- The node depends on proper configuration of the Surense OAuth2 credentials within n8n.
- No additional external dependencies are required beyond the Surense API access.
Troubleshooting
- Common Issues:
- Invalid or expired API credentials will cause authentication failures.
- Providing invalid values for pagination (e.g., zero or negative numbers) may result in errors.
- Using unsupported sort fields or orders might lead to unexpected results or API errors.
- Error Messages:
- Errors from the Surense API will be caught and can be output as error messages if "Continue On Fail" is enabled.
- Typical errors include authentication errors, rate limiting, or invalid parameter errors.
- Resolutions:
- Verify and refresh API credentials if authentication fails.
- Ensure pagination parameters are valid positive integers.
- Confirm that sorting options conform to allowed values.
Links and References
- Surense API Documentation (replace with actual URL)
- n8n OAuth2 Credential Setup Guide: https://docs.n8n.io/credentials/oauth2/
- Pagination Concepts in APIs: https://restfulapi.net/pagination/
Note: The above summary is based solely on static analysis of the provided source code and property definitions.