GOgofundme
GFM NPO Page

Update charity settings

Changed on

Updates the GoFundMe charity settings for an organization

put/organizations/{organization_id}/gfm-npo-page/settings

Request

  • Base URL
    https://pro.gofundme.com/api/2.0
  • Auth
    • OAuth 2
      Client credentials
      Token URL: /oauth2/auth
    • or OAuth 2
      Password
      Token URL: /oauth2/auth

Path parameters

organization_idinteger required
Example:123

The organization ID

Request body

status'ACTIVE' | 'INACTIVE' | 'HIDDEN' | 'BANNED' | 'UNKNOWN'

Charity Community status

isSeoIndexableboolean

Whether the charity should be indexed by search engines

allowsFundraiserCreationboolean

Whether the charity consents to fundraiser creation on its behalf

privacyPolicyUrlstring url

Privacy policy URL for the NPO's email opt-in; also mirrored to org_privacy_policy_url field (II-2355)

includeInRecommendationsboolean

Whether to include the charity in recommendations

marketplaceDiscoveryOptInboolean

Whether the charity opts into marketplace discovery across GoFundMe surfaces; translates to Consumer updateCharityPlacementOptInsAll bulk mutation (II-1807)

donationCadenceMandate'ONE_TIME_ONLY' | 'MONTHLY_ONLY' | 'SMART_DEFAULT'

Donation cadence mandate applied to campaigns benefiting the NPO; persisted in Consumer charities_meta (PRO-3407/PRO-4338)

autoThanksCoOptInboolean

Whether the charity auto-thanks the organizers who fundraise for it (II-2538)

autoThanksDonorOptInboolean

Whether the charity auto-thanks the donors who give to it directly (II-2538)

autoThanksFundraiserDonorOptInboolean

Whether the charity auto-thanks the donors of fundraisers run for it (II-2538)

Example request

{
  "status": "ACTIVE",
  "isSeoIndexable": true,
  "allowsFundraiserCreation": true,
  "privacyPolicyUrl": "https://example.org/privacy",
  "includeInRecommendations": true,
  "marketplaceDiscoveryOptIn": true,
  "donationCadenceMandate": "SMART_DEFAULT",
  "autoThanksCoOptIn": true,
  "autoThanksDonorOptIn": true,
  "autoThanksFundraiserDonorOptIn": true
}

Response

Charity settings updated successfully

successboolean

Example response

{
  "success": true,
  "data": {
    "updateCharitySettings": {
      "success": true,
      "charity_updated": 123,
      "privacy_policy_url_updated": true,
      "org_privacy_policy_url_updated": true,
      "recommendations_updated": true,
      "marketplace_discovery_updated": true,
      "donation_cadence_updated": "SMART_DEFAULT",
      "auto_thanks_co_updated": true,
      "auto_thanks_donor_updated": true,
      "auto_thanks_fundraiser_donor_updated": true,
      "updated_fields": [
        "status",
        "isSeoIndexable",
        "allowsFundraiserCreation",
        "privacyPolicyUrl",
        "includeInRecommendations",
        "marketplaceDiscoveryOptIn",
        "donationCadenceMandate",
        "autoThanksCoOptIn",
        "autoThanksDonorOptIn",
        "autoThanksFundraiserDonorOptIn"
      ]
    }
  }
}

Changes

  • c0287af7d094Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 6d020bee17ccRevision changes
    • info

      added the new optional request property

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status