---
title: "Enqueue a manual guarded Yelp ads job (create/pause/resume/edit budget)"
method: POST
path: "/app/yelp/ads-jobs/manual"
tags: ["App Yelp"]
---

# Enqueue a manual guarded Yelp ads job (create/pause/resume/edit budget)

`POST /app/yelp/ads-jobs/manual`

## Request

- Base URL: `https://api.optimyzee.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.optimyzee.com/app/yelp/ads-jobs/manual`
- Auth: none declared
- TypeScript: <https://skmtc.dev/optimyzee/apis/optimyzee-api/docs/app/yelp/ads-jobs/manual/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `programRef` string, nullable
  - `businessRef` string, nullable
  - `action` 'create_program' | 'edit_program' | 'update_features' | 'pause' | 'resume' | 'end_program' | 'edit_budget', required
  - `programName` 'CPC' | 'BP' | 'EP' | 'RCA' | 'CTA' | 'SLIDESHOW' | 'BH' | 'VL' | 'LOGO' | 'PORTFOLIO'
  - `direction` 'increase' | 'decrease'
  - `deltaPct` integer
  - `budgetCents` integer
  - `maxBidCents` integer, nullable
  - `pacingMethod` 'paced' | 'unpaced', nullable
  - `startDate` string, date, nullable
  - `endDate` string, date, nullable
  - `futureBudgetDate` string, date, nullable
  - `promotionCode` string, nullable
  - `currency` string, nullable
  - `isAutobid` boolean, nullable
  - `feePeriod` 'CALENDAR_MONTH' | 'ROLLING_MONTH', nullable
  - `adCategories` string[]
  - `features` object, nullable

## Response `200`

OK

- AppYelpAdsJobSchema
  - `id` integer, required
  - `recommendationId` integer, nullable, required
  - `recommendationTitle` string, nullable, required
  - `businessId` string, nullable, required
  - `businessName` string, nullable, required
  - `programRef` string, nullable, required
  - `action` string, required
  - `status` string, required
  - `requestedDirection` string, nullable, required
  - `requestedDeltaPct` integer, nullable, required
  - `currentBudgetCents` integer, nullable, required
  - `targetBudgetCents` integer, nullable, required
  - `guardrailsPassed` boolean, nullable, required
  - `partnerWriteEnabled` boolean, nullable, required
  - `blockReason` string, nullable, required
  - `message` string, nullable, required
  - `submittedAt` string, nullable, required
  - `checkedAt` string, nullable, required
  - `completedAt` string, nullable, required
  - `createdAt` string, nullable, required

---

[API](https://skmtc.dev/optimyzee/apis/optimyzee-api.md) - [All operations](https://skmtc.dev/optimyzee/apis/optimyzee-api/llms.txt) - [OpenAPI document](https://skmtc.dev/optimyzee/apis/optimyzee-api/revisions/ccaa14692e9f?raw)