Query: Find Email

Gmail Operation

The Find Email query searches for and retrieves a specific email in Gmail based on given criteria.

Example User Story

I want to find the contract email from Client X to reference the agreed terms for our meeting.

Fields

Field Name	Field Type	Required
query	String	Yes
maxResults	Integer	No

Related Connections

Gmail

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "find-email",
  "state": "inDev",
  "meta": {
    "short": "Find Email",
    "description": "Search for emails in a Gmail account based on specified criteria."
  },
  "input": [
    {
      "name": "query",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The search query to find emails (e.g., 'from:[e-mail]')."
      }
    },
    {
      "name": "maxResults",
      "type": "Integer",
      "required": false,
      "meta": {
        "description": "Maximum number of emails to return.",
        "default": "10"
      }
    }
  ],
  "output": [
    {
      "name": "emails",
      "type": "Array",
      "selector": ["emails"],
      "meta": {
        "description": "List of emails matching the search criteria."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "GET",
        "path": "/gmail/v1/users/me/messages",
        "queryParams": {
          "q": "{{query}}",
          "maxResults": "{{maxResults}}"
        },
        "headers": {}
      }
    }
  ]
}