---
title: "Create a transaction"
method: POST
path: "/v1/transactions"
tags: ["Transactions"]
---

# Create a transaction

`POST /v1/transactions`

## Request body

- StoreTransactionRequest
  - `campaign_code` string, nullable
  - `campaign_title` string
  - `campaign_team_id` integer, nullable
  - `team_member_id` integer, nullable
  - `contact_id` integer, nullable
  - `contact_external_id` string, nullable
  - `fund_code` string, nullable
  - `method` 'ach' | 'card' | 'cash' | 'check' | 'digital_wallet' | 'donor_advised_fund' | 'paypal' | 'venmo' | 'cashapp' | 'terminal' | 'stock' | 'in-kind' | 'property' | 'other' | 'none', required
  - `transacted_at` string, date-time, required
  - `mark_deposited` boolean, nullable
  - `timezone` string, nullable
  - `acknowledged_at` string, date-time, nullable
  - `external_label` string, nullable
  - `external_id` string, nullable
  - `contact_contact_since` string, date-time, nullable
  - `amount` string, required
  - `fee_covered` string, nullable
  - `platform_fee` string, nullable
  - `processing_fee` string, nullable
  - `check_number` string, nullable
  - `check_deposited_at` string, date-time, nullable
  - `company` string, nullable
  - `internal_note` string, nullable
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `email` string, nullable
  - `phone` string, nullable
  - `address_1` string, nullable
  - `address_2` string, nullable
  - `city` string, nullable
  - `state` string, nullable
  - `zipcode` string, nullable
  - `country` string, nullable
  - `dedication_type` 'in_memory_of' | 'in_honor_of'
  - `dedication_name` string, nullable
  - `dedication_recipient_name` string, nullable
  - `dedication_recipient_email` string, nullable
  - `giving_space_message` string, nullable
  - `appeal_code` string, nullable
  - `appeal_name` string, nullable
  - `appeal_status` string, nullable

## Response `200`

`TransactionResource`

- union
  - object
    - `id` string, required
    - `plan_id` string, required
    - `pledge_id` string, required
    - `amount` number, required
    - `fee` number, required
    - `fee_covered` number, required
    - `donated` number, required
    - `payout` number, required
    - `captured` string, required
    - `captured_at` string, required
    - `timezone` string, required
    - `refunded` string, required
    - `refunded_at` string, required
    - `line_items` TransactionLineItemResource[], required
      - `type` string, required
      - `subtype` string, required
      - `description` string, required
      - `quantity` integer, required
      - `price` number, required
      - `discount` number, required
      - `total` number, required
      - `created_at` string, required
      - `updated_at` string, required
    - `fair_market_value_amount` string, nullable, required
    - `tax_deductible_amount` string, nullable, required
    - `is_recurring` string, required
  - object
    - `id` string, required
    - `number` string, required
    - `campaign_id` string, required
    - `campaign_code` string, required
    - `campaign_title` string, required
    - `plan_id` string, required
    - `pledge_id` string, required
    - `team_id` string, required
    - `team_name` string, required
    - `member_id` string, required
    - `member_name` string, required
    - `fund_id` string, required
    - `fund_code` string, required
    - `contact_id` string, required
    - `first_name` string, required
    - `last_name` string, required
    - `company_name` string, required
    - `company` string, required
    - `email` string, required
    - `phone` string, required
    - `address` string, required
    - `status` string, required
    - `payment_method` string, required
    - `method` string, required
    - `is_offline` string, required
    - `check_number` union, required
      - string
      - object
    - `check_deposited_at` union, required
      - string
      - object
    - `internal_note` string, required
    - `amount` number, required
    - `fee` number, required
    - `fee_covered` number, required
    - `donated` number, required
    - `payout` number, required
    - `currency` string, required
    - `transacted_at` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `timezone` string, required
    - `giving_space` GivingSpaceResource, required
      - `id` string, required
      - `name` string, required
      - `amount` number, required
      - `message` string, required
      - `created_at` string, required
      - `updated_at` string, required
    - `dedication` DedicationResource, required
      - `type` string, required
      - `name` string, required
      - `recipient` object, required
        - `name` string, nullable, required
        - `email` string, nullable, required
      - `created_at` string, required
      - `updated_at` string, required
    - `transactions` unknown[], required
      - unknown
    - `custom_fields` CustomFieldResponseResource[], required
      - `id` integer, required
      - `field_id` integer, required
      - `title` string, required
      - `description` string, nullable, required
      - `type` string, required
      - `value` string, required
      - `created_at` string, required
      - `updated_at` string, required
    - `utm_parameters` string, required
    - `external_id` ExternalIdResource, required
      - `id` integer, required
      - `label` string, required
      - `external_id` string, required
      - `created_at` string, required
      - `updated_at` string, required
    - `communication_opt_in` string, required
    - `session_id` string, required
    - `attribution_data` string, required
    - `fair_market_value_amount` string, nullable, required
    - `tax_deductible_amount` string, nullable, required
    - `is_recurring` string, required
    - `payout_id` union, required
      - string
      - object

## Other responses

- `403` — Authorization error
- `404` — Not found
- `422` — Validation error

---

[API](https://skmtc.net/givebutter/apis/givebutter-api-documentation.md) · [All operations](https://skmtc.net/givebutter/apis/givebutter-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/givebutter/givebutter-api-documentation/revisions/b788722bbaf6/schema)