---
title: "Changes to Create a petition"
method: POST
path: "/api/v2/petitions"
---

# Changes to Create a petition

`POST /api/v2/petitions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 3 revisions.

- **2026-11-05** `d5c88ca497ac`: 4 breaking, 3 warning, 7 info
- **2026-02-14** `31995b0a1e61`: 5 breaking, 1 warning, 21 info

## Changes

- **2026-11-05** `d5c88ca497ac`: 4 breaking, 3 warning, 7 info
  - added `#/components/schemas/create_request_document, subschema #2` to the request body `allOf` list
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `201`
  - removed the required property `data` from the response with the `201` status
  - removed the request property `data`
  - removed the request property `included`
  - removed the optional property `included` from the response with the `201` status
  - added the media type `application/vnd.api+json` to the request body
  - added `#/components/schemas/show_document, subschema #2` to the response body `allOf` list for the response status `201`
  - media type `application/json` was changed to a more specific media type `application/vnd.api+json` for the response status `201`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `422`
  - added the non-success response with the status `429`
- **2026-02-14** `31995b0a1e61`: 5 breaking, 1 warning, 21 info
  - the request property `included/items/attributes/name` became not nullable
  - the request property `included/items/attributes/page_type_name` became not nullable
  - the request property `included/items/attributes/slug` became not nullable
  - the request property `included/items/attributes/title` became not nullable
  - the `data/attributes` request property type changed from no type to `object`
  - removed `#/components/schemas/petition_read_write_attributes, #/components/schemas/petition_write_only_attributes` from the `data/attributes` request property `allOf` list
  - added the new optional request property `data/attributes/additional_signatures_count`
  - added the new optional request property `data/attributes/auto_response_broadcaster_id`
  - added the new optional request property `data/attributes/auto_response_content`
  - added the new optional request property `data/attributes/auto_response_subject`
  - added the new optional request property `data/attributes/content`
  - added the new optional request property `data/attributes/gather_volunteers`
  - added the new optional request property `data/attributes/goal`
  - added the new optional request property `data/attributes/intro`
  - added the new optional request property `data/attributes/is_auto_response`
  - added the new optional request property `data/attributes/page_id`
  - added the new optional request property `data/attributes/petition_form_address`
  - added the new optional request property `data/attributes/petition_form_phone`
  - added the new optional request property `data/attributes/signature_name`
  - added the new optional request property `included/items/attributes/parent_id`
  - added the new optional request property `included/items/attributes/permission_level`
  - added the optional property `data/attributes/page_id` to the response with the `201` status
  - added the optional property `included/items/attributes/allOf[#/components/schemas/page_read_only_attributes]/ancestors_permission_level` to the response with the `201` status
  - added the optional property `included/items/attributes/allOf[#/components/schemas/page_read_only_attributes]/effective_permission_level` to the response with the `201` status
  - added the optional property `included/items/attributes/allOf[#/components/schemas/page_read_only_attributes]/parent_slug` to the response with the `201` status
  - added the optional property `included/items/attributes/allOf[#/components/schemas/page_read_write_attributes]/parent_id` to the response with the `201` status
  - added the optional property `included/items/attributes/allOf[#/components/schemas/page_read_write_attributes]/permission_level` to the response with the `201` status

---

[Operation](https://skmtc.dev/nationbuilder/apis/nationbuilder-v2-api/docs/api/v2/petitions/post.md) - [API](https://skmtc.dev/nationbuilder/apis/nationbuilder-v2-api.md) - [Page](https://skmtc.dev/nationbuilder/apis/nationbuilder-v2-api/changes/api/v2/petitions/post)