Search Contacts

Search your contacts by tags, field values, broadcast audience and more.

Avochato allows you to use special search parameters to isolate contacts based on Tags, Field Values, Created Date, Broadcast audience and more. Searches can be initiated within the Contacts tab of Avochato, and follow a common set of logic and search patterns.

Search by Tags

Using the following syntax (case sensitive), you can search for contacts using tags.

Find all contacts with two tags:

tags: “red” AND tags: “blue”

Notion image

Find all contacts with one of two tags:

tags: “red” OR tags: “blue”

Notion image

Find all contacts with one tag but not another:

tags: “red” AND NOT tags: “blue”

Notion image

Search by Created Date

Search contact by created date or created date range. Using the folowing syntax, you can search for contacts created between December 1, 2022 - December 31, 2022 with:

created_at: “2022/12/01...2022/12/31”

To search for a contact created on a specific date use created_at:"2022-12-08”

Search by Status, e.g. Landline

Search contacts by the following status attributes:

  • muted
  • landline
  • blocked
  • double_opted_in

To search by an attribute listed above add the following into the search bar:

blocked: false AND muted: true

Notion image


To identify contacts who have returned a 30006 landline error message, enter landline: true

Notion image

Search by Broadcast

Using the same logic, you can search contacts by broadcast audience. Each member of a broadcast’s audience has a hidden tag specific to that broadcast. To locate the hidden tag, navigate to the Broadcast results page and click on the specific broadcast. From there, click “X Contacts”

Notion image

This will direct you to a search in the inbox. You can copy this search parameter (tags: “broadcast:xyz”) and paste it into the Contacts tab like you would for any other tag. You can also string these together using “AND”, “OR”, or “NOT” commands as highlighted above.

Notion image
Notion image

You can also append different suffixes onto any particular broadcast tag to get more specific results. These include:

  • tags: “broadcast:XYZ:success”
    • Contacts for whom the broadcast message’s delivery is confirmed
  • tags: “broadcast:XYZ:failure”
    • Contacts for whom the broadcast message failed
  • tags: “broadcast:XYZ:attempted”
    • Contacts for whom the broadcast message was attempted (could include both successes and failures)
  • tags: “broadcast:XYZ:undelivered”
    • Contacts for whom the broadcast message was not attempted
  • tags: “broadcast:XYZ:replied”
    • Contacts that have replied to the initial broadcast message (before any subsequent outbound message took place)

Note: These appended tags can also be found by clicking various corresponding blue links on the Broadcast Results page

Search by Field Value

You also have the option of searching contacts by specific field value or custom field value.

Find all Contacts with a Specific Field Value:


fields:”favorite_movie=The Godfather”

  • Favorite Movie is the field name. When the field name is two+ words, the words need to be separated by an underscore, e.g. “favorite_movie” is correct, not “favorite movie”.
  • The Godfather is the field value. When the field value is two+ words, it does use spaces, not an underscore, .e.g. “The Godfather” is correct.
Notion image

Using the following syntax (case sensitive), you can search for contacts using custom fields.

fields:”field_name=field value”

Find all contacts with missing value

NOT _exists_:field

Example: NOT _exists_:name will pull a list of all contacts without a name in Avochato.

Did this answer your question?