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.42	2025-12-16	70726	Update dependencies
0.0.41	2025-11-25	69871	Update dependencies
0.0.40	2025-11-18	69412	Update dependencies
0.0.39	2025-10-29	69004	Update dependencies
0.0.38	2025-10-21	68299	Update dependencies
0.0.37	2025-10-14	67999	Update dependencies
0.0.36	2025-10-07	67258	Update dependencies
0.0.35	2025-09-30	66299	Update dependencies
0.0.34	2025-09-09	66063	Update dependencies
0.0.33	2025-08-23	65371	Update dependencies
0.0.32	2025-08-09	64626	Update dependencies
0.0.31	2025-08-02	64194	Update dependencies
0.0.30	2025-07-26	63861	Update dependencies
0.0.29	2025-07-19	63463	Update dependencies
0.0.28	2025-07-12	63123	Update dependencies
0.0.27	2025-07-05	62624	Update dependencies
0.0.26	2025-06-28	62169	Update dependencies
0.0.25	2025-06-21	61834	Update dependencies
0.0.24	2025-06-14	61134	Update dependencies
0.0.23	2025-05-24	60608	Update dependencies
0.0.22	2025-05-10	59895	Update dependencies
0.0.21	2025-05-03	59276	Update dependencies
0.0.20	2025-04-26	58813	Update dependencies
0.0.19	2025-04-19	58184	Update dependencies
0.0.18	2025-04-12	57732	Update dependencies
0.0.17	2025-04-05	57214	Update dependencies
0.0.16	2025-03-29	55947	Update dependencies
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