--- title: "Changes to Create Comment" method: POST path: "/comments" --- # Changes to Create Comment `POST /comments` > Every recorded change to this operation, newest first. ## Timeline Changed in 17 of 43 revisions. - **2026-11-02** `594190e20eb7`: 1 warning - **2026-10-27** `8fff9c6b1347`: 1 warning, 2 info - **2026-10-27** `7068f0150a0b`: 1 warning - **2026-10-20** `bc6be78752aa`: 1 info - **2026-10-15** `34e7903d33fe`: 1 warning - **2026-09-22** `f00fce908264`: 1 warning - **2026-09-16** `7ea9309802c6`: 1 warning, 1 info - **2026-09-11** `115438bc61dd`: 4 warning, 10 info - **2026-09-11** `129bca635a48`: 2 warning, 4 info - **2026-09-10** `d9c13cad7b22`: 1 warning, 5 info - **2026-08-27** `e0ac41d86464`: 2 info - **2026-08-08** `3a702c095d22`: 4 warning - **2026-08-05** `71b271a0f44a`: 1 warning - **2026-07-26** `fc5d382abadb`: 1 warning - **2026-07-13** `228cc05ba97d`: 3 warning, 2 info - **2026-06-07** `13f3bc084194`: 37 breaking, 33 warning, 11 info - **2026-01-17** `8590daeecaea`: 1 info ## Changes - **2026-11-02** `594190e20eb7`: 1 warning - added the new `comment_text_contains_link` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - **2026-10-27** `8fff9c6b1347`: 1 warning, 2 info - removed the optional property `email/anyOf[subschema #1: Email]/suppression_reason` from the response with the `201` status - removed the `email_address_noreply_local_part` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `suppressed` enum value from the `email/anyOf[subschema #1: Email]/status` response property for the response status `201` - **2026-10-27** `7068f0150a0b`: 1 warning - added the new `newsletter_unconfirmed_burst` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - **2026-10-20** `bc6be78752aa`: 1 info - added the optional property `email/anyOf[subschema #1: Email]/analytics/anyOf[subschema #1: Analytics]/attempts` to the response with the `201` status - **2026-10-15** `34e7903d33fe`: 1 warning - added the new `newsletter_resubmission_burst` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - **2026-09-22** `f00fce908264`: 1 warning - added the new `partially_sent` enum value to the `email/anyOf[subschema #1: Email]/status` response property for the response status `201` - **2026-09-16** `7ea9309802c6`: 1 warning, 1 info - added the new `email_address_plus_variant_burst` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `email_address_plus_variant_accounts` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - **2026-09-11** `115438bc61dd`: 4 warning, 10 info - added the new `email_address_local_part_looks_generated` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - added the new `ip_address_reputation` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - added the new `newsletter_trust` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - added the new `subscriber_import_trusted_origin` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `email_address_gmail_word_numbers` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `email_address_many_consonants_in_a_row` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `email_address_shannon_entropy` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `ip_address_peaceful` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `ip_address_prohibited` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `newsletter_age` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `newsletter_has_customized_transactional_email` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `newsletter_status` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `subscriber_import_provenance` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `subscriber_import_source` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - **2026-09-11** `129bca635a48`: 2 warning, 4 info - added the new `email_address_domain_reputation` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - added the new `email_address_reputation` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `email_address_esp_suppression` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `email_address_is_honeypot` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `email_address_peaceful_domain` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `email_address_prohibited_via_domain` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - **2026-09-10** `d9c13cad7b22`: 1 warning, 5 info - added the new `email_address_malformed` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `email_address_length` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `email_address_null_characters` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `email_address_regex` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `metadata_has_garbage` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `referrer_url_prohibited` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - **2026-08-27** `e0ac41d86464`: 2 info - removed the `email_address_cleantalk_score` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - removed the `ip_address_cleantalk_score` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - **2026-08-08** `3a702c095d22`: 4 warning - added the new `archive_only` enum value to the `email/anyOf[subschema #1: Email]/archival_mode` response property for the response status `201` - added the new `email_address_plus_variant_accounts` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - added the new `registration_without_prior_page_visit` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - added the new `username_shannon_entropy` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - **2026-08-05** `71b271a0f44a`: 1 warning - added the new `email_address_domain_burst` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - **2026-07-26** `fc5d382abadb`: 1 warning - added the new `smtp` enum value to the `email/anyOf[subschema #1: Email]/source` response property for the response status `201` - **2026-07-13** `228cc05ba97d`: 3 warning, 2 info - added the new `custom` enum value to the `email/anyOf[subschema #1: Email]/template/anyOf[subschema #1: EmailTemplate]/` response property for the response status `201` - added the new `ip_address_datacenter` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - added the new `shopify` enum value to the `subscriber/anyOf[subschema #1: Subscriber]/source` response property for the response status `201` - added the non-success response with the status `429` - removed the `email_address_stopforumspam_score` enum value from the `subscriber/anyOf[subschema #1: Subscriber]/firewall_reasons/items/code` response property for the response status `201` - **2026-06-07** `13f3bc084194`: 37 breaking, 33 warning, 11 info - the `text` request property's minLength was increased from `0` to `1` - added the pattern `[\s\S]*\S[\s\S]*` to the request property `text` - response property `parent_id` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - response property `subscriber_id` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - the `code` response's property type changed from no type to `string` for status `400` - the `code` response's property type changed from no type to `string` for status `403` - the `code` response's property type changed from no type to `string` for status `404` - the `email` response's property type changed from `object` to no type for status `201` - the `subscriber` response's property type changed from `object` to no type for status `201` - removed the required property `comment_type` from the response with the `201` status - removed the required property `email/absolute_url` from the response with the `201` status - removed the required property `email/body` from the response with the `201` status - removed the required property `email/canonical_url` from the response with the `201` status - removed the required property `email/commenting_mode` from the response with the `201` status - removed the required property `email/creation_date` from the response with the `201` status - removed the required property `email/description` from the response with the `201` status - removed the required property `email/featured` from the response with the `201` status - removed the required property `email/filters` from the response with the `201` status - removed the required property `email/id` from the response with the `201` status - removed the required property `email/image` from the response with the `201` status - removed the required property `email/modification_date` from the response with the `201` status - removed the required property `email/related_email_ids` from the response with the `201` status - removed the required property `email/should_trigger_pay_per_email_billing` from the response with the `201` status - removed the required property `email/source` from the response with the `201` status - removed the required property `email/status` from the response with the `201` status - removed the required property `email/subject` from the response with the `201` status - removed the required property `subscriber/creation_date` from the response with the `201` status - removed the required property `subscriber/email_address` from the response with the `201` status - removed the required property `subscriber/id` from the response with the `201` status - removed the required property `subscriber/referral_code` from the response with the `201` status - removed the required property `subscriber/secondary_id` from the response with the `201` status - removed the required property `subscriber/source` from the response with the `201` status - removed the required property `subscriber/tags` from the response with the `201` status - removed the required property `subscriber/type` from the response with the `201` status - removed the required property `subscriber/utm_campaign` from the response with the `201` status - removed the required property `subscriber/utm_medium` from the response with the `201` status - removed the required property `subscriber/utm_source` from the response with the `201` status - removed the optional property `annotation_data` from the response with the `201` status - removed the optional property `email/analytics` from the response with the `201` status - removed the optional property `email/attachments` from the response with the `201` status - …41 more - **2026-01-17** `8590daeecaea`: 1 info - endpoint added --- [Operation](https://skmtc.dev/buttondown/apis/buttondown-api/docs/comments/post.md) - [API](https://skmtc.dev/buttondown/apis/buttondown-api.md) - [Page](https://skmtc.dev/buttondown/apis/buttondown-api/changes/comments/post)