Gmail Custom icon

Gmail Custom

Interact with Gmail API with auto-refreshing token

Actions12

Draft → Get Many

AI-generated

Summary

Retrieve multiple draft emails from a user's Gmail account, optionally filtering with a Gmail query, including spam/trash, and limiting the number of results returned.

Inputs

  • Authentication (required) — Choose between using a Refresh Token (with auto-refresh) or a Bearer Token (manual) for Gmail API authentication.
  • Custom Refresh Token — Optionally override the refresh token from the credentials if using Refresh Token authentication.
  • Options — Additional parameters to customize the retrieval, including Gmail query string, include spam/trash toggle, max results limit (1-500), and further optional refresh token override.

Output shape

a list of draft objects, each representing a draft email in the user's Gmail account

The results are paginated up to the specified 'Max Results' limit per request. Each item in the output array contains JSON data for a single draft. If the query matches no drafts, an empty list is returned. Errors during retrieval can be handled with 'Continue on Fail' settings.

Discussion