guided-workflow

Finalize Video Campaigns

Finalize multiple draft video campaigns, then generate any deferred non-video campaigns.

post/api/guided-workflow/campaigns/generate-videos

Request

  • Base URL: https://api.usepomo.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.usepomo.ai/api/guided-workflow/campaigns/generate-videos
  • Auth: HTTP bearer

Request body

non_video_platformsstring[] nullable

Non-video platforms to generate after video finalize

target_platformsstring[] nullable

Original requested platforms (used to derive non-video)

platform_sub_formatsobject nullable

Platform-specific creative mode selections from the original request

num_adsinteger nullable

Number of ads per non-video platform

num_images_per_adinteger nullable

Images per non-video ad

reference_imagesstring[] nullable

Reference image data URLs

creative_referencesobject nullable
campaign_templateobject nullable

Zero or one template selected by id

provided_media_assetsobject[] nullable

User-provided media assets to use instead of generating primary video/image creative

lead_forms_by_platform_typeobject nullable

Lead form settings keyed by exact platform type

lead_form_enabledboolean nullable

Legacy Meta/LinkedIn finalize flag; forbidden for Google Search

lead_forms_by_ad_typeobject nullable

Legacy Meta/LinkedIn finalize config; forbidden for Google Search

max_cpcnumber nullable

Max CPC for manual bidding

objectivestring nullable

Campaign objective

ad_formatstring nullable

Ad format

video_lengthinteger nullable

Video duration is fixed at 10 seconds for video platforms

video_lengthsobject nullable

Optional map of platform ids to video duration; values are normalized to 10 seconds

video_qualitystring nullable

Default video quality for video platforms

video_qualitiesobject nullable

Optional map of platform ids to requested video quality

ugc_style_enabledboolean nullable

Whether to steer generated videos and seed images toward creator-led UGC style

use_fast_modelboolean nullable

Whether to use the Gemini fast video model (lite + 1080p) for finalized videos

user_promptstring nullable

Original user prompt/product description

locationsobject[] nullable

Structured target locations

product_offering_idstring uuid nullable

Product offering ID

countrystring nullable

Country for geo targeting

state_provincestring nullable

State/Province for geo targeting

citystring nullable

City for geo targeting

campaign_goalsstring[] nullable

Optional campaign goals

key_selling_pointsstring nullable

Optional key selling points

bid_strategystring nullable

Optional bidding strategy

budget_rangestring nullable

Optional budget range

budget_allocationobject nullable
budget_constraintsobject nullable
campaign_timingobject nullable
dayparting_enabledboolean nullable
dayparting_configobject nullable
campaign_opportunity_idstring uuid nullable

Trusted competitor campaign opportunity UUID returned by the draft job

execution_settings_job_idstring nullable

Accepted campaign-ideas job whose deferred fields this finalize must honor

execution_settings_draft_identitystring nullable

Builder draft identity bound to the accepted execution-settings receipt

product_descriptionstring nullable

Deprecated: use user_prompt

target_locationsobject[] nullable

Deprecated: use locations

Response

Successful Response

job_idstring required

Unique job identifier

statusstring required

Initial job status (typically 'running')

stream_urlstring required

SSE endpoint for real-time progress

poll_urlstring required

HTTP endpoint for polling status

Example response

{
  "job_id": "987fcdeb-51a2-43f7-9876-543210987654",
  "poll_url": "/api/chat/agentic/jobs/987fcdeb-51a2-43f7-9876-543210987654",
  "status": "running",
  "stream_url": "/api/chat/agentic/jobs/987fcdeb-51a2-43f7-9876-543210987654/stream"
}

Changes

No recorded changes to this operation across all 1 revision of this API.