Sign in

v1

latestOpenAPI 3.0.02026-08-062903562.2 MB
Comment

createStoryComment

Create Comment for specified Story

post/stories/{story}/comments

Path parameters

storyinteger required
Example:736

The specified Story ID

Request body

bodystring

The content of the Comment

Example request

{
  "body": "Example Comment"
}

Response

Success

bodystring

The content of the Comment

commentable_idinteger

Primary identifier of associated Commentable Entity

commentable_type'feed_item' | 'update' | 'story'

Type of associated Commentable Entity

commenter_namestring

The full name of the creator of the Comment. CFA semantics apply only to comments embedded in a parent FeedItem's latest_comments (the FeedItem-level getLatestCommentsAttribute override drives the privacy pass). For comments returned by the standalone Post / Story / Update comment endpoints, the legacy shape is preserved regardless of the org's Contact-First Architecture flag — those surfaces are tracked for migration under PRO-4055. When CFA applies (FeedItem-embedded path) and the flag is on (npo_apiv2_ff_contact_first_architecture), this returns the supporter-derived display name (or empty string when no Supporter is found) instead of the member's name. Prefer the new author_display_name field for new consumers — commenter_name is preserved for back-compat with existing apps and will be cleaned up per-app under PRO-2280.

author_display_namestring nullable

Supporter-derived display name for the comment author. Populated only on FeedItem-embedded comments (latest_comments) — the standalone Post / Story / Update comment endpoints do not include this property; that gap is tracked for migration under PRO-4055. On the FeedItem-embedded path: populated when the owning Organization has Contact-First Architecture enabled (npo_apiv2_ff_contact_first_architecture); also populated (often null) on the fail-closed path when the owning Organization cannot be resolved for the parent FeedItem on a supporter-bearing feedable type. Null when no Supporter record matches the commenter for that org. New consumers should prefer this field over commenter_name.

created_atstring date-time

Date/time of initial record creation

idinteger

Primary identifier of record

likes_countinteger

Amount of likes a Comment has received

member_idinteger

The ID of the Member that created of the Comment

updated_atstring date-time

Date/time of last record update

Example response

{
  "body": "Example Comment",
  "commentable_id": 72552,
  "commentable_type": "story",
  "commenter_name": "GoFundMe Pro Commenter",
  "author_display_name": "Pat Supporter",
  "created_at": "2021-04-23T08:23:21Z",
  "id": 47281,
  "likes_count": 5,
  "member_id": 2012,
  "updated_at": "2021-04-23T08:23:21Z"
}