Gmail¶
Connects your workspace to a Gmail account via the Carbon integration. This node designates Gmail as the data source and relies on shared Carbon logic to handle authentication, syncing, and data retrieval.
Usage¶
Use this node when you want to ingest or reference Gmail content (emails, threads, and possibly attachments) through the Carbon data layer. Place it at the start of a pipeline that needs Gmail data, then connect its outputs to downstream nodes that process, index, or analyze the retrieved content.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| Not specified | False | Not specified | Inputs are defined by the base Carbon data node and may include authentication context, scope, and optional filters for sync. This Gmail node only selects the Gmail integration. | Not specified |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| Not specified | Not specified | Outputs are defined by the base Carbon data node and typically include a reference or handle to the synced Gmail dataset or data stream for downstream processing. | Not specified |
Important Notes¶
- This node sets the integration to Gmail; all behavior (inputs/outputs) is inherited from the base Carbon data node.
- Authentication and authorization are required; ensure the user or workspace has completed Gmail OAuth within the Carbon layer.
- Sync behavior (full, incremental, filters) is controlled by the base Carbon node configuration and/or platform settings, not by this node directly.
- Email and attachment access depend on account permissions and organizational policies.
Troubleshooting¶
- Authentication errors: Reconnect the Gmail account through the platform’s Carbon connectors and ensure OAuth is valid.
- No data returned: Verify the connected Gmail account has accessible mail, check sync filters/range, and confirm the sync completed.
- Permission or scope issues: Confirm the OAuth scopes requested by the integration are granted and that the account/labels meet the filter criteria.
- Rate limits or throttling: If syncs stall or slow down, retry later or reduce the volume of requested data.