---
title: "Guess a Zap [Beta]"
method: POST
path: "/v2/guess"
tags: ["Zaps"]
---

# Guess a Zap [Beta]

`POST /v2/guess`

This endpoint returns a suggested Zap and pre-filled URL to Zapier from a given prompt.

## Query parameters

- `client_id` string, required

## Request body

- ZapGuesserRequest
  - `description` string, required — The description of the Zap you wish to create

## Response `200`

- ZapGuesserResponse
  - `title` string, required — The generated title for this suggested Zap.
  - `steps` ZapGuesserStep[], required — The steps this suggested Zap consists of.
    - `step` ZapGuesserRawStep, required
      - `title` string, nullable, required — The title of this step
      - `app` string, required — This step's human-readable name
      - `api` string, required — The Zapier API integration this step uses
    - `alternatives` ZapGuesserRawStep[], required — Alternative steps that we are less confident are relevant, but may have been intended
      - `title` string, nullable, required — The title of this step
      - `app` string, required — This step's human-readable name
      - `api` string, required — The Zapier API integration this step uses
  - `prefilled_url` string, required — A generated prefilled URL to take you to the Zapier editor (selects the highest confidence steps).
  - `messages` object[] — Contains informational messages about the prompt.

## Other responses

- `400` — This schema can be expected for 400 '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)