Canva Creator

Canva Creator

Scope

This skill handles a campaign in five sequential stages, each gated by owner approval:

brief → calendar → asset inventory → Canva designs → copy → HubSpot staging

Canva is not used for email rows under any circumstance — no templates, no autofill, no design copies, no asset uploads, no exports. Email graphics are out of scope for this skill because email-template autofill produces placeholder graphics when image slots exceed available photos, and variation thumbnails fail to render in chat previews. If the owner asks for a Canva email design, see reference/gotchas.md for the redirect language.

Pre-flight

Before Stage 1, confirm:

1. Brief. The user has referenced or pasted an approved brief. If not: "I'll need the content brief before I can build the campaign. Do you have one from the content-strategy skill, or would you like to write one now?"

1. Canva tier. Pro/Teams require manual template selection from the user's library (no autofill API). Enterprise can autofill from brand templates.

1. HubSpot tier. Social staging requires Marketing Hub Professional. Starter or Free → skip Stage 5 and export a CSV instead (see reference/hubspot-staging.md).

1. Brand assets. If a storefront is connected (Shopify or Square — peers, ../../shared/connector-neutrality.md), read the product list first: titles, image URLs, and prices for every product the brief names. Read only — nothing is uploaded to Canva until Stage 2 step 5, and then only the images the approved calendar's slots need. That list is the starting photo inventory; ask only about products the store has no image for. The pull rules — which fields, the price-claim rule — are in ../social-content-engine/reference/shopify-assets.md (written for Shopify; Square's catalog images follow the same steps from the tool inventory). With no storefront, confirm the path to product photos on disk or that the brand kit is live in Canva.

1. Generation budget. Estimate the campaign's Canva volume and surface it before Stage 1 begins. Default is 3 candidates per Canva-bound row; each design costs ~5 API calls (autofill + export + polling).

   Generation budget for this campaign:
     Canva (social) rows: 8
     Candidates per row:  3   (default — say "single candidate" to use 1)
     Total designs:       24
     API calls (approx):  ~120  (autofill + export + polling)

   Canva limit: 100 requests/minute. This will take ~2-3 minutes of
   generation, well within your tier limits. Proceed?

If the projected total designs exceeds 30, recommend single-candidate mode upfront — large campaigns run out of headroom fast. The owner can override the default to 1, 2, or 3 candidates per row before Stage 1 starts. Lock the chosen value for the entire session.

Workflow

Stage 1 — Posting calendar

Pull from the brief: content themes, channels, cadence, hard dates (launches, sales, holidays).

Build a calendar table with a Path column that routes every row to either Canva or text-only drafting:

Tag every email-channel row as Text-only before presenting. Cap at 30 days unless the brief specifies otherwise. Flag scheduling conflicts (two posts same day for the same product) up front.

Checkpoint 1. Present the calendar. Ask: "Does this match the plan? Any dates to shift, channels to add, or themes to swap?" Iterate until approved, then restate the split out loud — "N rows go through Canva, M rows go through text-only drafting" — before moving on. Catching a miscategorization here is free; catching it after generating designs isn't.

Stage 2 — Asset inventory (Canva rows only)

Email rows skip this stage entirely. For each Canva (social) row, build a manifest of what the template needs and what's already available.

1. Enumerate every image slot by name. Square Instagram posts usually have 1-2 image slots; carousels and product grids can have 5+. List them individually (Header_Image, Product1_Image, Product2_Image, …) — never roll them up as "product images."

• Enterprise: read field names from dataset[].label on the brand template (GET /v1/brand-templates/{id}).
• Pro/Teams: count every distinct image rectangle in the template.

1. Inventory available assets. Text content from the brief (product names, offer copy, taglines, pricing), product image URLs read from the connected storefront at pre-flight (uploaded in step 5, only for the slots the gap table needs, and recorded by asset.id then), product photos already uploaded to Canva (GET /v1/assets) or on the owner's disk, brand kit colors and fonts (Enterprise). A price in a caption comes from the storefront's returned value or the brief, never from memory.

1. Build the slot-by-slot gap table. One row per slot per design — not per design.

1. Resolve slot/asset mismatches with the owner. If the template has more image slots than the brief provides photos, pause and ask:

   The "Summer Carousel" template has 5 image slots. The brief gave me 1
   photo (bloom_summer.jpg). How should I fill the other 4?

     1. Reuse the same photo across all 5 slots
     2. You send me 4 more photos (file paths)
     3. Pick a simpler template with fewer slots

No generation calls until the owner picks. Generating with empty slots produces designs full of Canva's default landscape placeholders.

1. Upload missing photos and capture verified asset IDs. Upload via POST /v1/asset-uploads, then poll GET /v1/asset-uploads/{job_id} until status == "success". Record asset.id from the response — this is the only value that works in an autofill image field. Passing an empty string, a URL, a file path, or a stale ID silently renders Canva's stock landscape graphic instead of the photo.

1. Confirm the manifest. Show the owner the completed slot-by-slot table with every slot resolved and every image asset.id confirmed. This is the last stop before Canva API calls.

Stage 3 — Canva design generation

Before any Canva API call, re-read the calendar and drop any row whose Path is not Canva (social). Email rows do not pass through this stage.

Generate designs one calendar row at a time, with 3 candidates per row (or the value chosen at pre-flight). Each row follows the same loop: generate candidates → verify → export → visually check → retry failures → present → wait for owner pick → next row. Pause 30 seconds between rows. This caps the burst at 3 generations + 3 exports per ~30s — well under Canva's 100 req/min rate limit. Do not parallelize multiple rows; one row at a time is the protection that keeps the owner from hitting quota mid-campaign.