---
title: "Return all workflows"
method: GET
path: "/v3/grants/{grant_id}/workflows"
tags: ["Grant-level workflows"]
---

# Return all workflows

`GET /v3/grants/{grant_id}/workflows`

Returns all grant-level workflows for the specified grant.

## Query parameters

- `limit` integer
- `page_token` string

## Response `200`

Success. Returns list of workflows.

- object
  - `request_id` string, required — The ID of the request.
  - `data` Workflow[], required
    - `app_id` string, nullable — The ID of the Nylas application associated with the workflow. Returned only if the workflow is configured at the application level.
    - `date_created` integer, required — When the workflow was created, in seconds using the Unix timestamp format.
    - `delay` integer, required — The number of minutes between a `trigger_event` being met and the workflow sending a message.
    - `grant_id` string, nullable — The ID of the grant associated with the workflow. Returned only if the workflow is configured at the grant level.
    - `id` string, required — The ID of the workflow.
    - `is_enabled` boolean, required — When `true`, indicates that the workflow is enabled.
    - `name` string, required — The name of the workflow.
    - `template_id` string, required — The ID of the email template the workflow uses.
    - `trigger_event` 'booking.cancelled' | 'booking.created' | 'booking.pending' | 'booking.reminder' | 'booking.rescheduled', required — The event which triggers the workflow.
    - `from` object, nullable — Details of the sender if the workflow uses transactional send.
      - `email` string — The email address of the sender.
      - `name` string — The name of the sender.
  - `next_cursor` string, required — A cursor pointing to the next page of results for the request.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) · [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nylas/nylas-api/revisions/51c2c1b4ecff/schema)