---
title: "Get Actions"
method: GET
path: "/v2/actions"
tags: ["Actions", "Apps"]
---

# Get Actions

`GET /v2/actions`

Fetch the available actions for the provided App. It's typical to filter by type so that only actions that make sense for a particular step are shown. Action IDs may not be reused, see our documentation for how to hardcode a particular action.

#### When using Client ID

Simply providing a client ID query parameter is sufficient. If an Authorization header is present, it will be used instead.

#### When using OAuth

This endpoint requires the `zap` OAuth scope.

## Query parameters

- `action_type` 'READ' | 'READ_BULK' | 'SEARCH' | 'SEARCH_AND_WRITE' | 'SEARCH_OR_WRITE' | 'WRITE'
- `app` string, required

## Response `200`

- ActionsResponse[]
  - `links` Links, required — The links object returned in paginated response bodies.
    - `next` string, nullable — The URL of the next page of paginated results.
    - `prev` string, nullable — The URL of the previous page of paginated results.
  - `meta` BaseMeta, required — The meta object returned in paginated response bodies.
    - `count` integer, required — The total number of objects in the collection represented by the endpoint.
    - `limit` integer, nullable, required — The limit value used in the request.
    - `offset` integer — The offset value used in the request.
  - `data` Action[] — List of Actions for the provided App
    - `id` string, required — The ID to refer to this action (unstable, may change when referenced app changes)
    - `key` string, required — The developer provided identifier for this Action (stable)
    - `app` union, required — Apps
      - Apps — An app that integrates with Zapier
        - `id` string, required — Unique id of the app
        - `key` string, nullable — A stable, versionless key that identifies the app's current implementation (e.g. `HubSpotCLIAPI`).
        - `type` string — The type of this object.
        - `image` string, required — Default image/icon to represent the app.
        - `links` object, required — A url that, when visited, will direct the user to authenticate with the app and allow Zapier access to the app, thus creating a new Authentication. If value is `null`, then no authentication is required to use the app. Client ID-authenticated requests will never have this object's fields populated.
        - `action_types` unknown[], required — A list of action types for this specific App
          - unknown
        - `title` string, required — Human readable name of the app
        - `images` AppsImages, required — Images/icons of various resolutions to represent the app.
          - `url_16x16` string, required — 16x16 resolution image URL
          - `url_32x32` string, required — 32x32 resolution image URL
          - `url_64x64` string, required — 64x64 resolution image URL
          - `url_128x128` string, required — 128x128 resolution image URL
        - `hex_color` string, required — A branded color that can be used to represent the app.
        - `categories` Category[], required — A list of categories to which this app belongs. Helpful in identifying apps by type and functionality.
          - `slug` string, required — The shortened slug name for this category
        - `description` string, required — Human readable description of the app.
      - string
    - `type` 'action', required — * `action` - action
    - `action_type` 'action', required — * `action` - action
    - `is_instant` boolean, required — Will be set to `true` if this Action triggers instantly. May only be `true` when `type` is `READ`.
    - `title` string, required — The title of this Action.
    - `description` string, required — A longer description of this Action, usually describing what it does in more detail.

## Other responses

- `400` — This schema can be expected for 4xx 'Malformed request.' errors
- `401` — 401 Response
- `403` — 403 Response
- `409` — 409 Response
- `429` — 429 Response
- `500` — This schema can be expected for 5xx 'A server error occurred.' errors
- `503` — 503 Response
- `504` — 504 Response

---

[API](https://skmtc.dev/zapier/apis/trigger-inbox-api.md) · [All operations](https://skmtc.dev/zapier/apis/trigger-inbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zapier/trigger-inbox-api/revisions/3fc4c2846ba1/schema)