{
  "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:49Z",
  "sections": [
    {
      "id": "form",
      "title": "About this form",
      "blocks": [
        {
          "type": "facts",
          "items": [
            {
              "term": "Form id",
              "detail": [
                "newsletter"
              ]
            },
            {
              "term": "Purpose",
              "detail": [
                "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": [
                {
                  "text": "https://staging.zappian.in/blog/",
                  "href": "https://staging.zappian.in/blog/"
                }
              ]
            },
            {
              "term": "Where a person fills it in",
              "detail": [
                {
                  "text": "https://staging.zappian.in/blog/",
                  "href": "https://staging.zappian.in/blog/"
                }
              ]
            },
            {
              "term": "Can an agent send it",
              "detail": [
                "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": [
        {
          "type": "table",
          "head": [
            "Field",
            "Type",
            "Required",
            "Limits",
            "Allowed values",
            "What it is"
          ],
          "rows": [
            [
              "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": [
        {
          "type": "quote",
          "content": [
            "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": [
            {
              "term": "Version",
              "detail": [
                "c-c1cf6d03be3659a7"
              ]
            },
            {
              "term": "Privacy policy",
              "detail": [
                {
                  "text": "https://staging.zappian.in/privacy-policy/",
                  "href": "https://staging.zappian.in/privacy-policy/"
                }
              ]
            }
          ]
        },
        {
          "type": "paragraph",
          "content": [
            "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": [
        {
          "type": "list",
          "ordered": true,
          "items": [
            {
              "content": [
                "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": [
                "Then call submit_form with the same fields, consent, operator and an idempotency_key."
              ]
            }
          ]
        },
        {
          "type": "table",
          "head": [
            "Argument of submit_form",
            "Example value"
          ],
          "rows": [
            [
              "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": [
            "Every value in the example is made up. Replace each one with what your user gave you."
          ]
        }
      ]
    }
  ],
  "forms": [
    {
      "id": "newsletter",
      "title": "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": [
      "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": [
        "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
  }
}
