format: zappian-agent-view
version: 1
kind: forms
title: Newsletter
summary: "Subscribe an email address to the Zappian Media newsletter: news, stories and insights by email. The form is on the blog and beside each article."
path: /forms/newsletter/
urls:
  human: "https://staging.zappian.in/agent/forms/newsletter/"
  agent: "https://staging.zappian.in/agent/forms/newsletter/"
  markdown: "https://staging.zappian.in/agent/forms/newsletter.md"
  json: "https://staging.zappian.in/agent/forms/newsletter.json"
  formats:
    md: "https://staging.zappian.in/agent/forms/newsletter.md"
    json: "https://staging.zappian.in/agent/forms/newsletter.json"
    xml: "https://staging.zappian.in/agent/forms/newsletter.xml"
    toon: "https://staging.zappian.in/agent/forms/newsletter.toon"
generated: "2026-11-19T10:48:54Z"
sections[4]:
  - id: form
    title: About this form
    blocks[1]:
      - type: facts
        items[5]:
          - term: Form id
            detail[1]: newsletter
          - term: Purpose
            detail[1]: "Subscribe an email address to the Zappian Media newsletter: news, stories and insights by email. The form is on the blog and beside each article."
          - term: On these pages
            detail[1]{text,href}:
              "https://staging.zappian.in/blog/","https://staging.zappian.in/blog/"
          - term: Where a person fills it in
            detail[1]{text,href}:
              "https://staging.zappian.in/blog/","https://staging.zappian.in/blog/"
          - term: Can an agent send it
            detail[1]: "Not at the moment: this site has switched off sending by agents. A person completes this form on the site. check_form still works."
  - id: fields
    title: Fields
    blocks[1]:
      - type: table
        head[6]: Field,Type,Required,Limits,Allowed values,What it is
        rows[2]{Field,Type,Required,Limits,"Allowed values","What it is"}:
          email,text,yes,up to 254 characters; an email address,"",The email address to subscribe. It must be your user's own address.
          _hp,text,no,up to 200 characters,"","Leave this out. No person fills it in on the site, and a submission that fills it in is refused."
  - id: consent
    title: Consent
    blocks[3]:
      - type: quote
        content[1]: "We're committed to your privacy. Zappian uses the information you provide to us to contact you about our relevant content, products, and services. You may unsubscribe from these communications at any time. For more information, check out our privacy policy."
      - type: facts
        items[2]:
          - term: Version
            detail[1]: c-c1cf6d03be3659a7
          - term: Privacy policy
            detail[1]{text,href}:
              "https://staging.zappian.in/privacy-policy/","https://staging.zappian.in/privacy-policy/"
      - type: paragraph
        content[1]: "Send the version back as consent.version, with a consent.statement saying that your user asked for this submission and agreed to this text."
  - id: sending
    title: How to send it
    blocks[3]:
      - type: list
        ordered: true
        items[2]:
          - content[1]: "On the MCP server at https://staging.zappian.in/mcp, call check_form with form_id and fields. Nothing is stored or sent. Correct what it lists under problems."
          - content[1]: "Then call submit_form with the same fields, consent, operator and an idempotency_key."
      - type: table
        head[2]: Argument of submit_form,Example value
        rows[8]{"Argument of submit_form","Example value"}:
          form_id,newsletter
          fields.email,sample.person@example.com
          consent.version,c-c1cf6d03be3659a7
          consent.statement,My user asked me to send this form for them and agreed to the consent text of this version.
          operator.agent_name,Example Assistant
          operator.operator_name,Example Operator Ltd
          operator.operator_contact,agent-operator@example.com
          idempotency_key,newsletter-2026-01-15-0001
      - type: note
        content[1]: Every value in the example is made up. Replace each one with what your user gave you.
forms[1]{id,title}:
  newsletter,Newsletter
form:
  id: newsletter
  title: Newsletter
  purpose: "Subscribe an email address to the Zappian Media newsletter: news, stories and insights by email. The form is on the blog and beside each article."
  pages[1]: "https://staging.zappian.in/blog/"
  human_url: "https://staging.zappian.in/blog/"
  agent_submission: not_available
  input_schema:
    "$schema": "https://json-schema.org/draft/2020-12/schema"
    type: object
    properties:
      email:
        type: string
        maxLength: 254
        format: email
        pattern: "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
        description: The email address to subscribe. It must be your user's own address.
      _hp:
        description: "Leave this out. No person fills it in on the site, and a submission that fills it in is refused."
        type: string
        maxLength: 200
    required[1]: email
    additionalProperties: false
  consent:
    text: "We're committed to your privacy. Zappian uses the information you provide to us to contact you about our relevant content, products, and services. You may unsubscribe from these communications at any time. For more information, check out our privacy policy."
    version: c-c1cf6d03be3659a7
    privacy_url: "https://staging.zappian.in/privacy-policy/"
  operator_required: true