{
  "info": {
    "name": "Heyzine — mcp.ai",
    "description": "REST API for the Heyzine MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/heyzine",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "heyzine_create_flipbook_link",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/flipbook/link",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "flipbook",
            "link"
          ]
        },
        "description": "Tool to create a direct flipbook link. Use when you have a document URL and want to convert it to a flipbook.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"d\": \"\",\n  \"k\": \"\",\n  \"s\": \"\",\n  \"t\": \"\",\n  \"bg\": \"\",\n  \"ds\": \"\",\n  \"fs\": \"\",\n  \"lg\": \"\",\n  \"pn\": \"\",\n  \"sh\": \"\",\n  \"st\": \"\",\n  \"pdf\": \"\",\n  \"tpl\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyzine_create_flipbook_rest_async",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/flipbook/rest/async",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "flipbook",
            "rest",
            "async"
          ]
        },
        "description": "Tool to create a flipbook asynchronously. Use when converting large documents off-thread; poll for updates on conversion state.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"pdf\": \"\",\n  \"logo\": \"\",\n  \"tags\": \"\",\n  \"share\": false,\n  \"title\": \"\",\n  \"download\": false,\n  \"subtitle\": \"\",\n  \"template\": \"\",\n  \"client_id\": \"\",\n  \"prev_next\": false,\n  \"show_info\": false,\n  \"description\": \"\",\n  \"full_screen\": false,\n  \"private_note\": \"\",\n  \"background_color\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyzine_create_flipbook_rest_sync",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/flipbook/rest/sync",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "flipbook",
            "rest",
            "sync"
          ]
        },
        "description": "Tool to convert a PDF, DOCX, or PPTX into a flipbook synchronously via REST API. Use when you need immediate flipbook URLs from a direct file link.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"pdf\": \"\",\n  \"logo\": \"\",\n  \"tags\": \"\",\n  \"share\": false,\n  \"title\": \"\",\n  \"download\": false,\n  \"subtitle\": \"\",\n  \"template\": \"\",\n  \"client_id\": \"\",\n  \"prev_next\": false,\n  \"show_info\": false,\n  \"description\": \"\",\n  \"full_screen\": false,\n  \"private_note\": \"\",\n  \"background_color\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyzine_delete_flipbook",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/flipbook",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "flipbook"
          ]
        },
        "description": "Tool to delete a flipbook. Use when you need to permanently remove an unwanted flipbook.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyzine_get_api_limits",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/api/limits",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "api",
            "limits"
          ]
        },
        "description": "Tool to retrieve API rate limits. Use when you need to check your current API usage and limits.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyzine_get_flipbook_id_tool",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/flipbook/id/tool",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "flipbook",
            "id",
            "tool"
          ]
        },
        "description": "Tool to retrieve HTML for Flipbook ID tool. Use when you need to fetch the ID input tool page HTML for a specific flipbook.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"flipbook_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyzine_get_flipbook_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/flipbook/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "flipbook",
            "list"
          ]
        },
        "description": "Tool to retrieve all flipbooks. Use when you need to list every flipbook for the authenticated account.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"tag\": \"\",\n  \"page\": 0,\n  \"limit\": 0,\n  \"search\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyzine_get_flipbook_social_metadata",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/flipbook/social/metadata",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "flipbook",
            "social",
            "metadata"
          ]
        },
        "description": "Tool to retrieve social metadata for a specific flipbook. Use after configuring social sharing to fetch title, description, and thumbnail.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"flipbook_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyzine_get_j_query_plugin",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/j/query/plugin",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "j",
            "query",
            "plugin"
          ]
        },
        "description": "Tool to retrieve the Heyzine jQuery plugin script URL and usage snippet. Use when you need to integrate Heyzine flipbooks via jQuery on your website.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyzine_setup_webhooks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/setup/webhooks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "setup",
            "webhooks"
          ]
        },
        "description": "Helper tool to validate prerequisites for Heyzine webhooks. Heyzine does not expose an API to programmatically configure webhooks; this action verifies API connectivity and returns clear guidance to c",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"event\": \"\",\n  \"frequency\": 0,\n  \"endpoint_url\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyzine_update_flipbook_access_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/flipbook/access/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "flipbook",
            "access",
            "list"
          ]
        },
        "description": "Tool to update the access list of a flipbook. Use when replacing all user access permissions in bulk.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"access_list\": \"\",\n  \"flipbook_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyzine_update_flipbook_password_protection",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/flipbook/password/protection",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "flipbook",
            "password",
            "protection"
          ]
        },
        "description": "Tool to update flipbook password protection settings. Use when you need to change or disable password protection for a flipbook.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"mode\": \"\",\n  \"name\": \"\",\n  \"password\": \"\",\n  \"text_user\": \"\",\n  \"text_password\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyzine_update_flipbook_social_metadata",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/flipbook/social/metadata",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "flipbook",
            "social",
            "metadata"
          ]
        },
        "description": "Tool to update a flipbook's social metadata. Use when you need to change title, description, or thumbnail for social sharing.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"title\": \"\",\n  \"thumbnail\": \"\",\n  \"description\": \"\",\n  \"flipbook_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyzine_webhooks_leads",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/webhooks/leads",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "webhooks",
            "leads"
          ]
        },
        "description": "Tool to receive webhook events when new leads are collected on a flipbook form. Use after configuring your Heyzine account Webhooks > Leads URL.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}