Image Agent workflow
How Image Agent moves campaign imagery toward SFMC review.
Image Agent is Campaign Builder's workflow for finding, saving, generating, and inserting campaign imagery. It helps teams choose assets with source context and move selected images toward Salesforce Marketing Cloud without turning image work into an unchecked campaign launch.
Image workflow
From image need to reviewed Marketing Cloud asset.
Image Agent fits the production moment when campaign teams need to search providers, reuse SFMC images, save selected assets, or generate new imagery before an email, content block, or journey draft is reviewed.
Choose an image source
Image Agent exposes configured providers through /api/v1/agent/image/providers and supports Unsplash, Pexels, Pixabay, and SFMC image search where account settings and credentials allow it.
Search, preview, and save
Provider search requires a non-empty query for external providers, while SFMC search can list recent image assets. Saved image records preserve title, attribution, source, thumbnails, full URLs, page URLs, and dimensions.
Generate when credits allow
The chat workflow supports /generate, /imagine, and /nano commands. Generation uses surfaced image credits and optional generationRequestId values so retries can be idempotent for the same account and user.
Insert into Marketing Cloud
Confirmed insert-to-SFMC actions use connected Marketing Cloud credentials, upload-size limits, shared request-aware HTTP clients, and Content Builder folder permissions instead of hidden image writes.
Implementation map
What evaluators can trace to Image Agent routes.
The Image Agent route family is concrete: provider discovery, credit checks, search, saved assets, chat commands, context, feedback, and selected SFMC insertion are all separate reviewable surfaces.
GET /api/v1/agent/image/providers lists configured image providers available to the authenticated account.
GET /api/v1/agent/image/credits returns generation credit state used by /generate, /imagine, and /nano chat commands.
GET /api/v1/agent/image/search searches provider imagery; external provider searches require q, while SFMC search can list recent image assets.
GET /api/v1/agent/image/assets, POST /assets, and DELETE /assets/:id manage the account image library used for later campaign work.
POST /api/v1/agent/image/assets/:id/sfmc-insert uploads or inserts selected assets into Salesforce Marketing Cloud through connected credentials.
POST /api/v1/agent/image/chat supports image ideas, generation requests, provider selection, saved image lookup, context, feedback, and idempotent generation retries.
GET /api/v1/tools/blocks/image/search and POST /lead support Marketing Cloud-context image search, reviewed selections, crop/base64 uploads, and stored image lead evidence.
POST /api/v1/tools/blocks/image/gif/upload, GET /gif/uploads, and POST /gif/uploads/:id/copy support GIF Builder upload, listing, and copy workflows with rate limits and idempotency keys.
AI Image Block
Where in-place image block work touches Marketing Cloud.
Campaign Builder also includes Image Block routes for teams working inside a Marketing Cloud block flow. These routes are separate from Image Agent chat, but they share the same buyer concern: image operations should leave reviewable asset evidence instead of silently changing a campaign.
Search inside Marketing Cloud context
AI Image Block routes run only after authenticated Marketing Cloud context is present. The search endpoint can return Unsplash results or previously saved image_assets for the same account.
Capture reviewed image choices
The lead endpoint stores selected image details, crop data, source URLs, and Marketing Cloud asset responses so image choices can be reviewed after upload.
Upload assets to Content Builder
Selected URL or base64 images are uploaded through /asset/v1/content/assets as image asset type 28, then stored with published URL, customer key, version, account, and user metadata when Marketing Cloud returns it.
Build GIF outputs with replay protection
GIF Builder validates frame count, mime types, dimensions, and byte limits, rate-limits write requests, and supports idempotency keys for GIF upload and copy operations.
Evaluation evidence
What to ask for during an Image Agent pilot.
Image workflows are easiest to evaluate when the demo leaves concrete records: configured providers, saved source metadata, credit state, retry behavior, upload limits, and returned Marketing Cloud asset details.
Provider availability
Start with the providers endpoint and account image settings. External search should show the configured provider list, while empty external searches should return the expected Search query is required validation instead of silently broadening results.
Saved asset provenance
Review saved image_assets records for title, attribution, source, thumbnail URL, full URL, page URL, width, height, account ID, and user ownership before reusing imagery in a campaign.
Generation credit state
Ask to see the credits endpoint before generation. A /generate, /imagine, or /nano request should be evaluated against available image credits and account/user context.
Idempotent generation retry
When a generationRequestId is supplied, repeated generation attempts for the same account and user should resolve against the same request instead of creating duplicate charged work.
Upload boundary evidence
For SFMC insertion, capture connected credential context, folder permission result, IMAGE_AGENT_MAX_UPLOAD_BYTES behavior, request ID, and the returned Content Builder asset details.
Block and GIF controls
For AI Image Block or GIF Builder work, verify Marketing Cloud context, screenshot-to-img or gif-builder entitlement checks, payload validation, rate limits, and idempotency keys before treating an upload as review-ready.
Readiness gates
What must be configured before image work can reach SFMC.
Image Agent can support campaign production only when account-level provider settings, generation credits, and Marketing Cloud credentials match the action being attempted.
The account must have the agent:image-agent entitlement before the Image Agent route family is available.
External provider search depends on connected provider credentials in Account Settings -> Images.
Generation depends on available image credits surfaced by the credits endpoint.
SFMC insertion depends on connected Marketing Cloud credentials and folder permissions.
Large uploads are bounded by IMAGE_AGENT_MAX_UPLOAD_BYTES, with a default maximum of 10 MB.
AI Image Block endpoints require Marketing Cloud context and the screenshot-to-img entitlement; GIF Builder writes also require the gif-builder tool entitlement.
GIF Builder uploads validate at least two and at most 60 source frames, accepted image mime types, 16-4096px dimensions, 8 MB frame limits, and a 30 MB rendered GIF limit.
Technical evaluator FAQ
Where Image Agent helps, and where SFMC review remains.
The safest evaluation lens is asset preparation: Image Agent helps choose and move images, while final campaign approval and activation stay outside the image workflow.
Can Image Agent use existing SFMC images?
Yes. SFMC search can list recent image assets and supports the same Image Agent search surface when the connected Marketing Cloud account has access.
Does Image Agent track source details?
Saved images normalize title, attribution, source, thumbnail URL, full URL, page URL, width, and height so selected assets keep useful review context.
Can generated images be retried safely?
Generation requests may include generationRequestId so retries can be idempotent for the same account and user when the same request is submitted again.
Does inserting an image into SFMC launch anything?
No. Image Agent can upload or insert a selected asset through connected SFMC credentials, but campaign approval, email sends, and Journey activation remain reviewed Marketing Cloud steps.
How is GIF Builder different from Image Agent generation?
GIF Builder is an AI Image Block workflow for uploading reviewed source frames and rendered GIF outputs to Marketing Cloud. It validates frame payloads, rate-limits writes, and can reuse idempotency keys; it is not a limitless generation path.
Enterprise guardrails
Image production stays scoped and reviewable.
Image Agent extends Campaign Builder's SFMC execution layer, but it keeps provider access, credits, saved asset metadata, upload limits, and Marketing Cloud insertion boundaries explicit.
Entitlement and account scope
Image Agent routes run under authenticated account context and the image-agent entitlement before provider, library, chat, or SFMC insertion workflows are available.
Source and credit transparency
Saved image metadata keeps source and attribution fields, and generated-image flows use visible credit state rather than treating AI image creation as unlimited.
Confirmed SFMC insertion
Image Agent supports selected asset insertion into Marketing Cloud, but it does not approve campaigns, send emails, or activate journeys.
Marketing Cloud-only block work
AI Image Block operations require Marketing Cloud context, specific tool entitlements, validated payloads, rate limits, and idempotency controls before image or GIF uploads proceed.
Evaluation takeaway
Image Agent shortens asset preparation without hiding SFMC review.
A buyer evaluating Image Agent should expect configured provider search, saved image review context, generation credit checks, idempotent generation retries, and selected SFMC insertion. They should not expect it to approve creative, send campaigns, or activate Journey Builder flows.