airbyte/docs/integrations/sources/gmail.md

Gmail

Gmail is the email service provided by Google.

Configuration

Input	Type	Description	Default Value
client_id	string	OAuth Client ID.
client_secret	string	OAuth Client Secret.
client_refresh_token	string	Refresh token.
include_spam_and_trash	boolean	Include Spam & Trash. Include drafts/messages from SPAM and TRASH in the results. Defaults to false.	false

Note that this connector uses the Google API OAuth2.0 for authentication. To get started, follow the steps here to retrieve client_id and client_secret. See here for more detailed guide on the OAuth flow to retrieve the client_refresh_token.

Also note that the scope required here is https://www.googleapis.com/auth/gmail.readonly

Streams

Stream Name	Primary Key	Pagination	Supports Full Sync	Supports Incremental
profile		No pagination	✅	❌
drafts	id	DefaultPaginator	✅	❌
labels	id	No pagination	✅	❌
labels_details	id	No pagination	✅	❌
messages	id	DefaultPaginator	✅	❌
messages_details	id	No pagination	✅	❌
threads	id	DefaultPaginator	✅	❌
threads_details	id	No pagination	✅	❌

Changelog

Expand to review

Version	Date	Pull Request	Subject
0.0.15	2025-03-08	55265	Update dependencies
0.0.14	2025-03-01	54937	Update dependencies
0.0.13	2025-02-22	54417	Update dependencies
0.0.12	2025-02-15	53369	Update dependencies
0.0.11	2025-02-01	52831	Update dependencies
0.0.10	2025-01-25	52329	Update dependencies
0.0.9	2025-01-18	51700	Update dependencies
0.0.8	2025-01-11	51110	Update dependencies
0.0.7	2024-12-28	50536	Update dependencies
0.0.6	2024-12-21	50008	Update dependencies
0.0.5	2024-12-14	49474	Update dependencies
0.0.4	2024-12-12	49185	Update dependencies
0.0.3	2024-10-29	47852	Update dependencies
0.0.2	2024-10-28	47570	Update dependencies
0.0.1	2024-10-09		Initial release by @topefolorunso via Connector Builder