> ## Documentation Index
> Fetch the complete documentation index at: https://www.canva.dev/docs/apps/llms.txt
> Use this file to discover all available pages before exploring further.

# create-design-from-candidate

Turn a chosen candidate into a real, editable design.

Use `create-design-from-candidate` after the user picks a candidate from [generate-design](https://www.canva.dev/docs/apps/mcp/tools/generate-design/).

## Example prompt

*"Use the second option."*

Pass the chosen `candidate_id` and the top-level `job.id` from `generate-design`.

## Example response

IDs, URLs, and tokens below are placeholders; field names and structure are exactly as returned.

```json
{
  "design_summary": {
    "id": "DAF_EXAMPLE",
    "title": "AI Editing Feature Announcement in Electric Blue",
    "urls": { "edit_url": "https://www.canva.com/d/EXAMPLE_EDIT", "view_url": "https://www.canva.com/d/EXAMPLE_VIEW" },
    "created_at": 1784078449,
    "updated_at": 1784078449,
    "page_count": 1
  }
}
```

Returns a `design_summary` with the new design's `id`, `title`, `edit_url`, `view_url`, and `page_count`. Give the user the edit link.

## Learn more

* [MCP tools and rate limits](https://www.canva.dev/docs/apps/mcp/tools/)
* [generate-design](https://www.canva.dev/docs/apps/mcp/tools/generate-design/)
* [Verify your Canva MCP app](https://www.canva.dev/docs/apps/mcp/verify-app/)
* [Design edit handoff](https://www.canva.dev/docs/apps/mcp/workflows/design-edit/)