To trigger a workflow whenever you receive an email, you can use the Gmail Trigger. This keeps a watch on your Gmail and triggers a workflow everytime a new email is received. You can also watch for certain email labels e.g., INBOX, SPAM, IMPORTANT
Triggers are not available for Free Accounts
You can find the Gmail Trigger in Triggers > Gmail Trigger
To setup a Gmail Trigger, click on the + Gmail Trigger. It will open a modal where you will enter details regarding the trigger like :
Name of the Gmail Trigger
Maximum number of runs allowed by the Trigger
Expiry Date of the Trigger
Email Labels you want to keep a watch on.
Checkboxes for when you want to be notified when a new message is received or removed from the INBOX
To access the data of your Gmail trigger, such as the email’s subject, body etc. You’ll need to drag an input block into the flow builder and specify the required name in the input_name of the input block.
sender_email - The email address of the sender.
sender_name - The name of the sender.
receiver_name - The name of the receiver.
receiver_email - The email address of the receiver.
email_subject - The subject of the email.
email_body - The body of the email in plain text.
email_date - The date and time the email was sent or received.
email_attachments - A list of download URLs for the attachments included within the email.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Keyflow Docs","colors":{"primary":"#E0580B","light":"#ED6A2F","dark":"#E0580B"},"favicon":"/favicon.svg","logo":{"light":"https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/logo/logo.png?fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=9f29f07c607b76fd7a3618d3a5c4af87","dark":"https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/logo/logo.png?fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=9f29f07c607b76fd7a3618d3a5c4af87"},"background":{"decoration":null,"color":{"light":"#FDFDFF","dark":"#0D0D0D"}},"navbar":{"links":[{"label":"Support","href":"mailto:founders@keyflow.space"}],"primary":{"type":"button","label":"Get Started","href":"https://keyflow.space/signup"}},"footer":{"socials":{"twitter":"https://twitter.com/keyflowapp","linkedin":"https://www.linkedin.com/company/keyflow-space/","discord":"https://discord.gg/AZv6JqPFX6"}},"integrations":{"posthog":{"apiKey":"phc_PsVwZfJy0Vrz19oOCFsXngtAITUEM9y4TYDw18Bsvn7","apiHost":"https://app.posthog.com/"}},"navigation":{"global":{"anchors":[{"anchor":"Discord","href":"https://discord.gg/AZv6JqPFX6","icon":"discord"},{"anchor":"Changelog","href":"https://keyflow.space/changelog","icon":"newspaper"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"keyflow-25","hasAudioNarration":false,"actualSubdomain":"keyflow-25","customDomains":["docs.keyflow.space"],"gitSource":{"type":"github","owner":"trillhouse-studio","repo":"keyflow-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21e616cf44a63d52c9648f","collectionId":"79a22f54-e7d3-4fda-9af0-e2c1b5f8dac4","schemaVersion":"v2"},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{},"buildId":"6a21e616cf44a63d52c9648f:success","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Documentation","count":101},{"language":"default","tag":"Blocks","count":84},{"language":"default","tag":"Data Loaders","count":22},{"language":"default","tag":"AI","count":19},{"language":"default","tag":"Data Modifiers","count":19},{"language":"default","tag":"Data Writers","count":15},{"language":"default","tag":"App Essentials","count":12},{"language":"default","tag":"Core","count":4},{"language":"default","tag":"API Reference","count":3},{"language":"default","tag":"Endpoint","count":3}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"triggers/gmail-trigger","slug":"/triggers/gmail-trigger","pageMetadata":{"title":"Gmail Trigger","description":"Trigger a workflow whenever you receive an email","href":"/triggers/gmail-trigger"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Trigger a workflow whenever you receive an email\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,OptimizedImage,Warning}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`To trigger a workflow whenever you receive an email, you can use the Gmail Trigger. This keeps a watch on your Gmail and triggers a workflow everytime a new email is received. You can also watch for certain email labels e.g., `,_jsx(_components.code,{children:`INBOX`}),`, `,_jsx(_components.code,{children:`SPAM`}),`, `,_jsx(_components.code,{children:`IMPORTANT`})]}),`\n`,_jsx(Warning,{children:` Triggers are not available for Free Accounts `}),`\n`,_jsxs(_components.p,{children:[`You can find the Gmail Trigger in `,_jsx(_components.code,{children:`Triggers`}),` > `,_jsx(_components.code,{children:`Gmail Trigger`})]}),`\n`,_jsxs(Frame,{children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-light.png?fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=7e7a846adc830509a04a4b43fb6aa6e5`,alt:`Gmail Trigger`,\"data-og-width\":`1919`,width:`1919`,\"data-og-height\":`415`,height:`415`,\"data-path\":`images/triggers/gmail-trigger-light.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-light.png?w=280\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=c9687fc5f778ce1adf178243cbfceab6 280w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-light.png?w=560\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=e180ff810ba238042e899f01eef06013 560w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-light.png?w=840\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=d404c388bb66d7356ced44c10a30023b 840w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-light.png?w=1100\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=94029186718a028377c2eef9283c490d 1100w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-light.png?w=1650\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=b95af4933a297c5f0fb302cd57e69cdb 1650w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-light.png?w=2500\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=a594df7cd88d397ea031f6850270b968 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-dark.png?fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=5442a7d75e45c66235b5b442e78ec3ce`,alt:`Gmail Trigger`,\"data-og-width\":`1919`,width:`1919`,\"data-og-height\":`415`,height:`415`,\"data-path\":`images/triggers/gmail-trigger-dark.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-dark.png?w=280\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=71091be6cbf3e9bf08839b5a4a863f4d 280w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-dark.png?w=560\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=52cd6bf6b0d281f2a47eb21810d4df0a 560w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-dark.png?w=840\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=ca331fd870089b3e89b8c6a803cf5518 840w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-dark.png?w=1100\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=9bfea5cce87918c85364fe277f3e3885 1100w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-dark.png?w=1650\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=77b9c1e344caf457341d18811b1673fe 1650w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-dark.png?w=2500\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=5f822057e91bd359ccc0a6d2cdd53704 2500w`})]}),`\n`,_jsx(Heading,{level:`3`,id:`create-gmail-trigger`,children:`Create Gmail Trigger`}),`\n`,_jsxs(_components.p,{children:[`To setup a Gmail Trigger, click on the `,_jsx(_components.code,{children:`+ Gmail Trigger`}),`. It will open a modal where you will enter details regarding the trigger like :`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Name of the Gmail Trigger`}),`\n`,_jsx(_components.li,{children:`Maximum number of runs allowed by the Trigger`}),`\n`,_jsx(_components.li,{children:`Expiry Date of the Trigger`}),`\n`,_jsx(_components.li,{children:`Email Labels you want to keep a watch on.`}),`\n`,_jsxs(_components.li,{children:[`Checkboxes for when you want to be notified when a new message is received or removed from the `,_jsx(_components.code,{children:`INBOX`})]}),`\n`]}),`\n`,_jsxs(Frame,{children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-modal-light.png?fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=bfc4f3ea733cc2f4e6f9293e9d8c70f0`,alt:`Add Gmail Trigger`,\"data-og-width\":`511`,width:`511`,\"data-og-height\":`557`,height:`557`,\"data-path\":`images/triggers/gmail-trigger-modal-light.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-modal-light.png?w=280\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=e47965621205eb633ba37d7159b7741a 280w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-modal-light.png?w=560\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=339eff18ddb90d65bdc692c5792772af 560w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-modal-light.png?w=840\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=04d8a964068f437e0f7c46fe6f841d88 840w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-modal-light.png?w=1100\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=0c60804324feb03b915d9dfb1b84975f 1100w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-modal-light.png?w=1650\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=12dc210fe8ddcae443a7142eb34c02da 1650w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-modal-light.png?w=2500\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=9fb360aed3c5a87cbc9a4ca33c3c6950 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-modal-dark.png?fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=d4e61c873bd59535176dc1f618567e84`,alt:`Add Gmail Trigger`,\"data-og-width\":`509`,width:`509`,\"data-og-height\":`557`,height:`557`,\"data-path\":`images/triggers/gmail-trigger-modal-dark.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-modal-dark.png?w=280\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=adf7acc799eee9851b31cac8a2c9fbc6 280w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-modal-dark.png?w=560\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=84262452ac0abaf2db7c2f3cf8bc9427 560w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-modal-dark.png?w=840\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=4f46de3d04ad1454e099760117a8a142 840w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-modal-dark.png?w=1100\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=e8a72666e61dc43674bc271f6e311c86 1100w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-modal-dark.png?w=1650\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=8dc912075e29e3ea089b777aaef1f895 1650w, https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/images/triggers/gmail-trigger-modal-dark.png?w=2500\u0026fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=fee1fefa7cc92dbbf90b9d19fba808bd 2500w`})]}),`\n`,_jsx(_components.p,{children:`To access the data of your Gmail trigger, such as the email’s subject, body etc. You’ll need to drag an input block into the flow builder and specify the required name in the input_name of the input block.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`sender_email`}),` - The email address of the sender.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`sender_name`}),` - The name of the sender.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`receiver_name`}),` - The name of the receiver.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`receiver_email`}),` - The email address of the receiver.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`email_subject`}),` - The subject of the email.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`email_body`}),` - The body of the email in plain text.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`email_date`}),` - The date and time the email was sent or received.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`email_attachments`}),` - A list of download URLs for the attachments included within the email.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`message_id`}),` - The message id of the email.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Gmail Trigger","description":"Trigger a workflow whenever you receive an email","href":"/triggers/gmail-trigger"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Create Gmail Trigger","slug":"create-gmail-trigger","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"dynamicCss":".mint-block {\n display: block\n}\n.mint-hidden {\n display: none\n}\n.dark\\:mint-block:is(.dark *) {\n display: block\n}\n.dark\\:mint-hidden:is(.dark *) {\n display: none\n}","subdomain":"keyflow-25","siteName":"Keyflow Docs","title":"Gmail Trigger - Keyflow Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T00:46:47.800Z","originalFileLocation":"triggers/gmail-trigger.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Trigger a workflow whenever you receive an email\">\u003cmeta data-mint-head name=\"application-name\" content=\"Keyflow Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/keyflow-25/wCfjKhrErHdPIrvG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/keyflow-25/wCfjKhrErHdPIrvG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/keyflow-25/wCfjKhrErHdPIrvG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/keyflow-25/wCfjKhrErHdPIrvG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/keyflow-25/wCfjKhrErHdPIrvG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/keyflow-25/wCfjKhrErHdPIrvG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/keyflow-25/wCfjKhrErHdPIrvG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/keyflow-25/wCfjKhrErHdPIrvG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/keyflow-25/wCfjKhrErHdPIrvG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Gmail Trigger - Keyflow Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Trigger a workflow whenever you receive an email\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Keyflow Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.keyflow.space/triggers/gmail-trigger\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://keyflow-25.mintlify.app/_mintlify/api/og/v2?division=Triggers\u0026amp;title=Gmail+Trigger\u0026amp;description=Trigger+a+workflow+whenever+you+receive+an+email\u0026amp;theme=e14017b53275d5faefca739b\u0026amp;signature=3d237a3c377e3bfa2a9e8194edf906be234da2d2fcb06f5cedfdf76e2de3bed8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Gmail Trigger - Keyflow Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Trigger a workflow whenever you receive an email\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://keyflow-25.mintlify.app/_mintlify/api/og/v2?division=Triggers\u0026amp;title=Gmail+Trigger\u0026amp;description=Trigger+a+workflow+whenever+you+receive+an+email\u0026amp;theme=e14017b53275d5faefca739b\u0026amp;signature=3d237a3c377e3bfa2a9e8194edf906be234da2d2fcb06f5cedfdf76e2de3bed8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/keyflow-25/wCfjKhrErHdPIrvG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Keyflow Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E0580B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.keyflow.space/triggers/gmail-trigger\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/triggers/gmail-trigger.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.keyflow.space/#organization\",\"name\":\"Keyflow Docs\",\"url\":\"https://docs.keyflow.space\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/keyflow-25/fFpWQxpuiZM1VmdD/logo/logo.png?fit=max\u0026auto=format\u0026n=fFpWQxpuiZM1VmdD\u0026q=85\u0026s=9f29f07c607b76fd7a3618d3a5c4af87\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.keyflow.space#website\",\"name\":\"Keyflow Docs\",\"url\":\"https://docs.keyflow.space\",\"publisher\":{\"@id\":\"https://docs.keyflow.space/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.keyflow.space/triggers/gmail-trigger#webpage\",\"url\":\"https://docs.keyflow.space/triggers/gmail-trigger\",\"name\":\"Gmail Trigger\",\"description\":\"Trigger a workflow whenever you receive an email\",\"dateModified\":\"2026-01-07T00:46:47.800Z\",\"isPartOf\":{\"@id\":\"https://docs.keyflow.space#website\"},\"breadcrumb\":{\"@id\":\"https://docs.keyflow.space/triggers/gmail-trigger#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.keyflow.space/triggers/gmail-trigger#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Triggers\",\"item\":\"https://docs.keyflow.space/triggers/api-trigger\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Gmail Trigger\",\"item\":\"https://docs.keyflow.space/triggers/gmail-trigger\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.keyflow.space/triggers/gmail-trigger#article\",\"headline\":\"Gmail Trigger\",\"name\":\"Gmail Trigger\",\"description\":\"Trigger a workflow whenever you receive an email\",\"url\":\"https://docs.keyflow.space/triggers/gmail-trigger\",\"mainEntityOfPage\":{\"@id\":\"https://docs.keyflow.space/triggers/gmail-trigger#webpage\"},\"dateModified\":\"2026-01-07T00:46:47.800Z\",\"publisher\":{\"@id\":\"https://docs.keyflow.space/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.keyflow.space#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Keyflow Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Keyflow Docs","nav":{"global":{"anchors":[{"anchor":"Discord","href":"https://discord.gg/AZv6JqPFX6","icon":"discord"},{"anchor":"Changelog","href":"https://keyflow.space/changelog","icon":"newspaper"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Quickstart","href":"/quickstart"}]},{"group":"App Essentials","pages":[{"title":"Key Terms","href":"/app-essentials/key-terms"},{"title":"Batch Mode","href":"/app-essentials/batch-mode"},{"title":"Compute Units","href":"/app-essentials/compute-units-in-keyflow"},{"title":"AI Agents","href":"/app-essentials/ai-agents"},{"title":"App View","href":"/app-essentials/app-view"},{"title":"Integrations","href":"/app-essentials/integrations"},{"title":"Nesting Flows","href":"/app-essentials/external-flows"},{"title":"Blueprints","href":"/app-essentials/share-flows"},{"title":"Triggers","href":"/app-essentials/trigger-flows"},{"title":"Files","href":"/app-essentials/files-in-keyflow"},{"title":"Runs History","href":"/app-essentials/runs-history"},{"title":"Edit History","href":"/app-essentials/edit-history"}]},{"group":"Blocks","pages":[{"group":"Core","pages":[{"title":"Input","href":"/blocks/core/input"},{"title":"Output","href":"/blocks/core/output"},{"title":"Call API","href":"/blocks/core/call-api"},{"title":"Note","href":"/blocks/core/note"}]},{"group":"Data Loaders","pages":[{"title":"Read File","href":"/blocks/data-loaders/read-file"},{"title":"Read ZIP File","href":"/blocks/data-loaders/read-zip-file"},{"title":"Read From Google Sheets","href":"/blocks/data-loaders/read-from-google-sheets"},{"title":"Read From Google Docs","href":"/blocks/data-loaders/read-from-google-docs"},{"title":"Search Google","href":"/blocks/data-loaders/search-google"},{"title":"Crawl Web","href":"/blocks/data-loaders/crawl-web"},{"title":"Scrape Hacker News","href":"/blocks/data-loaders/scrape-hacker-news"},{"title":"Scrape Leetcode","href":"/blocks/data-loaders/scrape-leetcode"},{"title":"Read Gmail","href":"/blocks/data-loaders/read-gmail"},{"title":"Read Outlook","href":"/blocks/data-loaders/read-outlook"},{"title":"Scrape Reddit","href":"/blocks/data-loaders/scrape-reddit"},{"title":"Extract CSV Rows","href":"/blocks/data-loaders/extract-csv-rows"},{"title":"Extract CSV Column","href":"/blocks/data-loaders/extract-csv-columns"},{"title":"Get Typeform Responses","href":"/blocks/data-loaders/get-typeform-responses"},{"title":"Scrape Website","href":"/blocks/data-loaders/scrape-website"},{"title":"Enrich Company Information","href":"/blocks/data-loaders/enrich-company-information"},{"title":"Enrich People Information","href":"/blocks/data-loaders/enrich-people-information"},{"title":"Get Youtube Transcript","href":"/blocks/data-loaders/get-youtube-transcript"},{"title":"Read Notion Page","href":"/blocks/data-loaders/read-notion-page"},{"title":"Read Notion Database","href":"/blocks/data-loaders/read-notion-database"},{"title":"Extract Notion Database Properties","href":"/blocks/data-loaders/extract-notion-database-properties"},{"title":"Read JSON","href":"/blocks/data-loaders/read-json"}]},{"group":"AI","pages":[{"title":"Ask AI","href":"/blocks/ai/ask-ai"},{"title":"Define OpenAI Function","href":"/blocks/ai/define-openai-function"},{"title":"Scorer","href":"/blocks/ai/scorer"},{"title":"Generate Image","href":"/blocks/ai/generate-image"},{"title":"Describe Image","href":"/blocks/ai/describe-image"},{"title":"Query Image","href":"/blocks/ai/query-image"},{"title":"Categorizer","href":"/blocks/ai/categorizer"},{"title":"AI Filter","href":"/blocks/ai/ai-filter"},{"title":"Text to Speech","href":"/blocks/ai/text-to-speech"},{"title":"Speech to Text","href":"/blocks/ai/speech-to-text"},{"title":"Similarity Search","href":"/blocks/ai/similarity-search"},{"title":"Summarizer","href":"/blocks/ai/summarizer"},{"title":"AI Web Search","href":"/blocks/ai/ai-web-search"},{"title":"Extract Single Item","href":"/blocks/ai/extract-single-item"},{"title":"Extract List Item","href":"/blocks/ai/extract-list-item"},{"title":"Extract Text (OCR)","href":"/blocks/ai/extract-text-ocr"},{"title":"Perplexity Web Search","href":"/blocks/ai/perplexity-web-search"},{"title":"Translate","href":"/blocks/ai/translate"},{"title":"Cohere RAG","href":"/blocks/ai/cohere-rag"}]},{"group":"Data Modifiers","pages":[{"title":"Text","href":"/blocks/data-modifiers/text"},{"title":"Modify Text","href":"/blocks/data-modifiers/modify-text"},{"title":"Create List","href":"/blocks/data-modifiers/create-list"},{"title":"Read List Element","href":"/blocks/data-modifiers/read-list-element"},{"title":"JSON","href":"/blocks/data-modifiers/json"},{"title":"Parse JSON","href":"/blocks/data-modifiers/parse-json"},{"title":"Write JSON","href":"/blocks/data-modifiers/write-json"},{"title":"Find and Replace","href":"/blocks/data-modifiers/find-and-replace"},{"title":"Sort CSV","href":"/blocks/data-modifiers/sort-csv"},{"title":"Split Text","href":"/blocks/data-modifiers/split-text"},{"title":"Join Text Array","href":"/blocks/data-modifiers/join-text-array"},{"title":"Filter","href":"/blocks/data-modifiers/filter"},{"title":"Chunk Text","href":"/blocks/data-modifiers/chunk-text"},{"title":"Update CSV Column","href":"/blocks/data-modifiers/update-csv-column"},{"title":"Sentence Search","href":"/blocks/data-modifiers/sentence-search"},{"title":"Clone","href":"/blocks/data-modifiers/clone"},{"title":"Trim List","href":"/blocks/data-modifiers/trim-list"},{"title":"Flatten List","href":"/blocks/data-modifiers/flatten-list"},{"title":"Concatenate Lists","href":"/blocks/data-modifiers/concat-lists"}]},{"group":"Flow Control","pages":[{"title":"If-else","href":"/blocks/flow-control/if-else"},{"title":"Switch","href":"/blocks/flow-control/switch"},{"title":"Mux","href":"/blocks/flow-control/mux"}]},{"group":"Data Writers","pages":[{"title":"Send Slack Message","href":"/blocks/data-writers/send-slack-message"},{"title":"Send Discord Message","href":"/blocks/data-writers/send-discord-message"},{"title":"Generate File","href":"/blocks/data-writers/generate-file"},{"title":"Create Asana Task","href":"/blocks/data-writers/create-asana-task"},{"title":"Send Gmail","href":"/blocks/data-writers/send-gmail"},{"title":"Write to Google Docs","href":"/blocks/data-writers/write-to-google-docs"},{"title":"Write to Google Sheets","href":"/blocks/data-writers/write-to-google-sheets"},{"title":"Write to Notion Database","href":"/blocks/data-writers/write-to-notion-database"},{"title":"Write to Notion Page","href":"/blocks/data-writers/write-to-notion-page"},{"title":"Send Outlook","href":"/blocks/data-writers/send-outlook"},{"title":"Tweet","href":"/blocks/data-writers/tweet"},{"title":"Write ZIP File","href":"/blocks/data-writers/write-zip-file"},{"title":"Send Email Notification","href":"/blocks/data-writers/send-email-notification"},{"title":"Send Whatsapp","href":"/blocks/data-writers/send-whatsapp"},{"title":"Send Text Message","href":"/blocks/data-writers/send-text-message"}]},{"group":"Database I/O","pages":[{"title":"Load Cached Output","href":"/blocks/database-io/load-cached-output"},{"title":"PostgreSQL","href":"/blocks/database-io/postgresql"}]}]},{"group":"Triggers","pages":[{"title":"API Trigger","description":"Trigger a workflow by sending API request","href":"/triggers/api-trigger"},{"title":"Gmail Trigger","href":"/triggers/gmail-trigger"},{"title":"Schedule Trigger","description":"Trigger a workflow at a specific time in future","href":"/triggers/schedule-trigger"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/endpoint/flows/trigger-flow"}]}]},"basePath":"","title":"Gmail Trigger - Keyflow Docs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DXXFP6nH.js","DynamicMarkdown-B54_zNBF.js","zoom-image-lightbox-BG6oD64b.js","lightbox-handle-r17bVUz3.js"]}