Zendesk Search Contact by Phone

Search for Zendesk contacts by phone number and optionally create a new contact if none is found.

This action searches for Zendesk contacts using a phone number as the search parameter. When executed, it performs the following steps:

  1. Searches for users with the specified phone number
  2. If contacts are found, returns them in the response
  3. If no contacts are found and the 'Create Contact' option is enabled:
    • Creates a new contact with the provided phone number
    • Uses the optional name (if provided) or generates a default name using contact number
    • Adds the optional email (if provided)
    • Returns the newly created contact in the response

This action is particularly useful for integrating with telephony systems or for identifying customers who call your support line.

Action Inputs

NameTypeDescription
Zendesk SubdomainCredentialsThe Zendesk subdomain. i.e. if the Zendesk URL is company.zendesk.com then the subdomain will be company
Zendesk EmailCredentialsThe Zendesk API user email with "/token" appended to the end. i.e. [email protected]/token
Zendesk TokenCredentialsThe Zendesk API token. You can retrieve this from the Zendesk Admin area
Phone NumberStringPhone number to search for
Create ContactBooleanWhether to create a new contact if none is found with the given phone number
Contact NameString(Optional) Name to use when creating a new contact (defaults to 'Contact [phone_number]')
Contact EmailString(Optional) Email to use when creating a new contact

Action Outputs

NameTypeDescription
SuccessBooleanWhether the operation completed successfully
Contacts FoundBooleanWhether any contacts were found with the given phone number
ContactsObjectArray of contacts found with the given phone number
Contact CountNumberNumber of contacts found with the given phone number
Contact CreatedBooleanWhether a new contact was created
Created ContactObjectThe newly created contact (if one was created)
StatusStringStatus of the operation ('success' or 'failure')