Buttondown Documentation

Buttondown Documentation

© 2016–2025 Buttondown LLC.

TwitterGitHubLinkedInMastodonBlueskyFacebook

Creating a comment

Create a new comment or reply to an existing comment. Authors can respond to comments at the given author.

Sample requests

These sample requests are autogenerated by the OpenAPI spec.

import requests

url = "https://api.buttondown.com/v1/comments"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}

response = requests.request("POST", url, headers=headers)
print(response.text)

Sample responses

The IDs and values referenced in these responses are fake; please only rely on these responses for overall structure.

{
    "id": "13121cd6-0dfc-424c-bb12-988b0a32fcb3",
    "creation_date": "2020-09-29T00:00:00+00:00",
    "email_id": "13121cd6-0dfc-424c-bb12-988b0a32fcb3",
    "subscriber_id": "13121cd6-0dfc-424c-bb12-988b0a32fcb3",
    "parent_id": null,
    "text": "This is a test comment",
    "comment_type": "subscriber",
    "annotation_data": {},
    "subscriber": null,
    "email": null
}

Body parameters

All parameters are optional unless explicitly specified.

text

Type
string · required
Description

The text content of the comment

parent_id

Type
string
Description

The ID of the parent comment, if this comment is a reply to another comment.

email_id

Type
string
Description

The ID of the email this comment is for. Required if parent_id is not provided.

© 2016–2025 Buttondown LLC.

TwitterGitHubLinkedInMastodonBlueskyFacebook