---
title: "/contributions"
method: POST
path: "/contributions"
---

# /contributions

`POST /contributions`

## Request

- Base URL: `https://api.securevan.com/v4`
- URL: `https://api.securevan.com/v4/contributions`
- Auth: HTTP basic

Use this endpoint to create a new contribution with the properties provided in the request body. If successful, the endpoint responds with HTTP Status Code `201 Created` and the integer ID of the created Contribution in the response body. If any of the specified ids (`vanId`, `pledgeId`, `codeId`, or `extendedSourceCodeId`) are not accessible in the current context (e.g., the associated api user does not have access to the contact), the request will be considered invalid.

## Request body

- object
  - `contact` object, required: The [Person](ref:people) who contributed
    - `vanId` string
  - `designation` object, required: The [Designation](ref:designations) which will receive funds associated with this Contribution.
    - `designationId` integer
  - `dateReceived` string, date-time, required: The date and time of this contribution; must occur before the time of the API call.
  - `amount` number, double, required: The amount of the contribution. Must be between $0.01 and $999,999.99 inclusive, unless disclosure fields are enabled, in which case all positive or negative values are allowed. May not have more than 2 digits after the decimal point.
  - `status` 'Pending' | 'Declined' | 'Settled' | 'Deposited' | 'InKind', required: The current status of the contribution
  - `paymentType` 'Check' | 'MoneyOrder' | 'Cash' | 'CreditCard' | 'InKind' | 'Unknown' | 'ElectronicFundsTransfer' | 'ElectronicPaySystem' | 'Stock' | 'ApplyPay' | 'PaycheckDeduction' | 'WireTransfer', required: A string representing the method of payment.
  - `codes` object[]: An array of zero or one [Codes](ref:codes) to apply to the contribution. Contributions may not have more than one Code applied, and if a Code is applied, it must be a Source Code.
    - `codeId` integer, required
    - `codeName` string
  - `generalLedgerFund` object: The associated GeneralLedgerFund object.
    - `generalLedgerFundId` integer: ID of the general ledger fund
  - `costCenter` object: The associated CostCenter object.
    - `costCenterId` integer: ID of the CostCenter
  - `directMarketingCode` string: The direct marketing code.
  - `notes` string: A note describing the Contribution.
  - `extendedSourceCode` object: The [Extended Source Code](ref:extended-source-codes) object to apply to the Contribution. Only the extendedSoureCodeId property is required. If this is provided and no `codes` are provided, we’ll look for and apply a matching Source Code to the contribution from a Direct Response Plan segment that the contact is in with a contact history record that has the extended source code. If no matching source code is found, then the POST will fail.
    - `extendedSourceCodeID` integer: The ID of the extended source code to associate with this commitment
  - `financialBatchId` integer: The ID of the associated [Financial Batch](ref:financial-batches). Required if Financial Batch Manager is enabled in the committee context; not allowed if Financial Batch Manager is disabled in the committee context. If specified, the Designation of the Financial Batch must match the Designation of the contribution.
  - `pledge` object: The pledge associated with this contribution
    - `pledgeId` integer
  - `customFieldValues` object[]: An array of one or more custom fields
    - `customFieldId` integer: The ID of the custom field
    - `customFieldGroupId` integer: The group ID of the custom field.
    - `assignedValue` string: The value to be assigned to the custom field. If populating a checkbox, set value to 0 or 1. If populating a dropdown, set value to ID of selection.

## Response `201`

201

- integer

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `500`: 500

## Changes

- **2026-11-03** `4f2049fba5af`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ngpvan/apis/van-crm/changes/contributions/post.md)

---

[API](https://skmtc.dev/ngpvan/apis/van-crm.md) - [All operations](https://skmtc.dev/ngpvan/apis/van-crm/llms.txt) - [OpenAPI document](https://skmtc.dev/ngpvan/apis/van-crm/revisions/4f2049fba5af?raw)