Sign in

v1

latestOpenAPI 3.0.02026-08-062903562.2 MB
Feed Item

createOrganizationFeedItem

Create a FeedItem (Comment) for specified Organization

post/organizations/{organization_id}/feed-items

Path parameters

organization_idinteger required
Example:82364

The specified Organization ID

Request body

commentstring

Comment for the Organization

Example request

{
  "comment": "I just want to say that I think you all are doing a great job. Keep up the good work!"
}

Response

Success

idinteger

Primary identifier of record

agent_idinteger nullable

Primary identifier of the Agent that performed interaction associated with Feed Item

agent_type'member' | 'business' nullable

Type of Agent that performed interaction associated with Feed Item

agent_namestring nullable

Name of Agent that performed interaction associated with Feed Item. When the owning Organization has Contact-First Architecture enabled (npo_apiv2_ff_contact_first_architecture), Member-morph agents return the supporter-derived display name; for creation-type items on fundraising_page / fundraising_team feedables with no Supporter, the page / team title is the fallback (only when it does not match the author member's snapshotted name); otherwise null. Business agents are unaffected. Prefer the new author_display_name field for new consumers — agent_name is preserved for back-compat with existing apps and will be cleaned up per-app under PRO-2280.

member_namestring nullable

Snapshotted name of the Member associated with the Feed Item (legacy alias preceding the polymorphic agent relation). When the owning Organization has Contact-First Architecture enabled, this is replaced with the supporter-derived display name; for creation-type items on fundraising_page / fundraising_team feedables with no Supporter, the page / team title is the fallback (only when it does not match the author member's snapshotted name); for Business agents and otherwise null. Prefer the new author_display_name field for new consumers — member_name is preserved for back-compat with existing apps and will be cleaned up per-app under PRO-2280.

feedable_idinteger

Primary identifier of Fundraising Entity associated with Feed Item’s described interaction

feedable_typestring

Type of the Fundraising Entity associated with Feed Item’s described interaction

feedable_valuestring nullable

Name or title of the Item. Under Contact-First Architecture (npo_apiv2_ff_contact_first_architecture), this is null when feedable_type is fundraising_page or fundraising_team (any row type) — the snapshotted page / team title would otherwise re-leak member-seeded names from unguarded write paths (CompleteRegistrations, CreateFundraisingPageForLead, and the registration-recovery commands).

linkable_idinteger nullable

Primary identifier of Entity whose creation, update, or association is described by Feed Item

linkable_typestring nullable

Type of the Entity whose creation, update, or association is described by Feed Item

linkable_valuestring nullable

Name or title of the Entity whose creation, update, or association is described by Feed Item. Under Contact-First Architecture (npo_apiv2_ff_contact_first_architecture), this is null when linkable_type is fundraising_page or fundraising_team (any row type — the snapshotted page / team title would otherwise re-leak member-seeded names), and for TYPE_ASSOCIATION items where linkable_type is a Member morph (the persisted column would otherwise re-leak the member's full name).

linkable_effective_atstring date-time

Date/time when Linkable is effective

type'comment' | 'onboarding' | 'creation' | 'update' | 'association'

Type of the Item

commentstring

Comment

comments_countinteger nullable

Amount of Comments that the Feed Item has

likes_countinteger nullable

Amount of Likes that the Feed has

created_atstring date-time

Date/time when object was created

updated_atstring date-time

Date/time when object was updated

visibility'public' | 'admin'

Visibility status of the Item

author_display_namestring nullable

Supporter-derived display name for the item author. Populated when the owning Organization has Contact-First Architecture enabled (npo_apiv2_ff_contact_first_architecture); also populated on the fail-closed path when the owning Organization cannot be resolved on a supporter-bearing feedable type (soft-deleted feedable, etc.) — Business-agent items surface the business display name and Member-agent items surface null. Resolves to the supporter's first + last name for member-authored items, the business display name for Business-agent items, or null when no Supporter record matches and no safe fallback is available. New consumers should prefer this field over member_name / agent_name.

Example response

{
  "id": 987,
  "agent_id": 438475,
  "agent_type": "member",
  "agent_name": "John Doe",
  "member_name": "Jane Doe",
  "feedable_id": 4857,
  "feedable_type": "campaign",
  "feedable_value": "GoFundMe Pro fundraising campaign",
  "linkable_id": 4832,
  "linkable_type": "fundraising_page",
  "linkable_value": "How to keep donors engaged",
  "linkable_effective_at": "2021-04-23T10:25:03Z",
  "type": "creation",
  "comment": "I just want to say that I think you all are doing a great job. Keep up the good work!",
  "comments_count": 78,
  "likes_count": 8,
  "created_at": "2021-04-23T10:25:03Z",
  "updated_at": "2021-04-23T10:25:03Z",
  "visibility": "public",
  "latest_comments": [
    {
      "body": "Example Comment",
      "commentable_id": 876,
      "commentable_type": "feed_item",
      "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"
    }
  ],
  "author_display_name": "Pat Supporter"
}