Yourang icon

Yourang

Interact with yourang.ai - 24/7 AI phone assistant for calls, contacts, and events

Actions56

Contact → Get Many

AI-generated

Overview

This node operation retrieves multiple contact records from the Yourang.ai platform. It supports filtering contacts by various fields such as email, first name, last name, and phone number, and allows combining these filters using AND or OR logic. Users can also apply advanced filter queries with logical operators for more complex searches. The operation can return all matching contacts or limit the number of results, and supports sorting by fields like creation date, email, first name, or last name in ascending or descending order. This is useful for scenarios where you need to fetch and process customer contact data in bulk, such as syncing contacts with a CRM, generating contact lists for campaigns, or analyzing customer information.

Use Case Examples

  1. Fetch all contacts with the last name 'Doe' and sort them by creation date descending.
  2. Retrieve up to 50 contacts filtered by email domain and first name, combining filters with AND logic.
  3. Use an advanced filter query to get contacts where first name is 'John' or last name is 'Smith' and email contains 'example.com'.
  4. Get all contacts without any filters, sorted by email ascending.

Properties

Name Meaning
Return All Whether to return all results or only up to a given limit.
Limit Maximum number of contact results to return when 'Return All' is false.
Search Collection of search filters to apply on contacts, including email, first name, last name, phone number, and how to combine these filters (AND/OR).
Advanced Filter Query An advanced filter query string using OR (|) and AND (&) operators to override simple filters for complex search conditions.

Output

JSON

  • id - Unique identifier of the contact.
  • email - Email address of the contact.
  • first_name - First name of the contact.
  • last_name - Last name of the contact.
  • phone_number - Phone number of the contact.
  • created_at - Timestamp when the contact was created.

Dependencies

  • Yourang API key credential

Troubleshooting

  • If the node returns an error about unknown resource, ensure the resource parameter is set to 'Contact'.
  • If no contacts are returned, verify the filter criteria and ensure there are matching contacts in the Yourang system.
  • Errors related to authentication indicate issues with the Yourang API key credential; verify the credential is correctly configured and valid.
  • If the node fails on some items but continues on others, check the 'Continue On Fail' setting to handle partial failures gracefully.

Links

Discussion