---
title: "Fetch Emails"
method: POST
path: "/email-integrations/{integration_id}/fetch-emails"
tags: ["email-integrations"]
---

# Fetch Emails

`POST /email-integrations/{integration_id}/fetch-emails`

On-demand fetch of a Gmail account's messages by label and/or search query.

## Path parameters

- `integration_id` string, required

## Query parameters

- `label` string, nullable — Gmail label name, e.g. 'NoSo - PO'
- `query` string, nullable — Raw Gmail search, e.g. 'from:x subject:code newer_than:1h'
- `max_results` integer
- `max_pages` integer
- `persist` boolean
- `return_messages` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/noso/apis/crucible-backend-api.md) · [All operations](https://skmtc.dev/noso/apis/crucible-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/noso/crucible-backend-api/revisions/112efbdea3eb/schema)