Add Headers and Footers

CopiedDefault font for all positions: No font_name or font_size specified. All positions will use the default font (roboto, size 10).

curl --location --request POST "https://{zohoapis_domain}/pdfeditor/api/v1/pdf/content/headerfooter" \
  --header "Authorization: Zoho-oauthtoken xxx.yyy.zzz" \
  --form 'file=@/Users/username/Documents/Original.pdf' \
  --form 'password="pdf_password"' \
  --form 'input_options={
    "header_options": [
      { "position": "center", "text": "Confidential Document" },
      { "position": "right", "text": "<<mm/dd/yyyy>>" }
    ],
    "footer_options": [
      { "position": "left", "text": "<<Page 1 of n>>" },
      { "position": "right", "text": "Generated by Zoho" }
    ],
    "margins": { "margin_top": 15, "margin_bottom": 10, "margin_left": 10, "margin_right": 15 },
    "page_range": { "start_page": 1 }
  }'

CopiedOne font for all positions: A single global font_settings group is set. All positions inherit this font — no need to specify font individually for each position.

curl --location --request POST "https://{zohoapis_domain}/pdfeditor/api/v1/pdf/content/headerfooter/store" \
  --header "Authorization: Zoho-oauthtoken xxx.yyy.zzz" \
  --form 'file=@/Users/username/Documents/Original.pdf' \
  --form 'password="pdf_password"' \
  --form 'input_options={
    "header_options": [
      { "position": "center", "text": "Annual Report 2026" },
      { "position": "right", "text": "<<mm/dd/yyyy>>" }
    ],
    "footer_options": [
      { "position": "center", "text": "<<Page 1 of n>>" },
      { "position": "right", "text": "Company Inc." }
    ],
    "font_settings": { "font_name": "lato_bold", "font_size": 11 },
    "margins": { "margin_top": 12, "margin_bottom": 12, "margin_left": 15, "margin_right": 15 }
  }' \
  --form 'output_settings={"name": "Report_With_Headers.pdf", "folder_id": "<folder_id>", "overwrite_existing_file": true}'

CopiedDifferent fonts per positions: Each position specifies its own font_name and font_size. Positions without per-position font settings fall back to the global font_settings (or the default roboto if omitted).

curl --location --request POST "https://{zohoapis_domain}/pdfeditor/api/v1/pdf/content/headerfooter/callback" \
  --header "Authorization: Zoho-oauthtoken xxx.yyy.zzz" \
  --form 'file=@/Users/username/Documents/Original.pdf' \
  --form 'password="pdf_password"' \
  --form 'input_options={
    "header_options": [
      { "position": "left", "text": "<<yyyy-mm-dd>>", "font_name": "nunito_italic", "font_size": 9 },
      { "position": "center", "text": "Draft", "font_name": "montserrat_bold", "font_size": 14 }
    ],
    "footer_options": [
      { "position": "right", "text": "<<1/n>>" }
    ],
    "font_settings": { "font_name": "roboto", "font_size": 8 },
    "page_range": { "start_page": 2 }
  }' \
  --form 'callback={"invoke_url": "https://www.example.com/v1/api/callback/savecallback", "timeout": 120, "retry_interval": 60, "http_method_type": "post"}'