CHchariot-giving
sources

Create a Source

Creates a custom source scoped to your organization. Use this when you receive gifts from a provider Chariot doesn't yet have in its canonical directory.

post/v1/sources

Request

  • Base URL
    https://sandboxapi.givechariot.com
  • URL
    https://sandboxapi.givechariot.com/v1/sources
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

The idempotency key for the request.

Request body

namestring required

The human-readable name of the source.

logostring uri nullable

URL of the source's logo, if one is available.

Example request

{
  "name": "Local Community Foundation",
  "logo": "https://localcommunityfoundation.org/logo.png"
}

Response

The source was created.

idstring required

The unique identifier for the source.

namestring required

The human-readable name of the source.

scope'canonical' | 'custom' required

Who owns this source.

  • canonical — maintained by Chariot and shared across every organization. Read-only.
  • custom — created by an organization for its own use, and mutable by that organization.
logostring uri nullable

URL of the source's logo, if one is available.

created_atstring date-time required

When this source was added to the directory.

updated_atstring date-time required

When this source was last modified.

Example response

{
  "id": "source_01m12tn300eh20gdqscje7s5jw",
  "name": "Fidelity Charitable",
  "scope": "canonical",
  "logo": "https://cdn.givechariot.com/payers/fidelity_charitable.png",
  "created_at": "2026-09-28T12:34:56Z",
  "updated_at": "2026-09-28T12:34:56Z"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.