---
title: "Create thank you for contribution"
method: POST
path: "/open-api/v1.0/thank-you-contributions/{id}"
tags: ["Thank yous"]
---

# Create thank you for contribution

`POST /open-api/v1.0/thank-you-contributions/{id}`

## Request

- Base URL: `https://api.fourthwall.com`
- URL: `https://api.fourthwall.com/open-api/v1.0/thank-you-contributions/{id}`
- Auth: one of:
  - OAuth 2
    - Implicit: `https://auth.staging.fourthwall.com/auth/realms/Fourthwall/protocol/openid-connect/auth`
    - Scopes: `thankyou_write`
  - HTTP basic

*Rate limit: 100 requests / 10 seconds per shop. See [Rate limiting](/guides/rate-limiting).*

Upload thank you media for a contribution (order, donation, membership, etc.)

## Path parameters

- `id` string, required

## Request body `multipart/form-data`

- object
  - `file` string, binary, required

## Response `201`

Created

- ComFourthwallOpenapiModelThankYouV1
  - `id` string, required
  - `mediaUrl` string, required
  - `contribution` union, required
    - ComFourthwallOpenapiModelThankYouContributionDonation
      - `type` 'DONATION', required
      - `id` string, required
      - `shopId` string, required
      - `supporter` ComFourthwallOpenapiModelThankYouContributionSupporter, required
        - `email` string, required
        - `username` string
        - `message` string
    - ComFourthwallOpenapiModelThankYouContributionGiftPurchase
      - `type` 'GIFT_PURCHASE', required
      - `id` string, required
      - `shopId` string, required
      - `supporter` ComFourthwallOpenapiModelThankYouContributionSupporter, required
        - `email` string, required
        - `username` string
        - `message` string
    - ComFourthwallOpenapiModelThankYouContributionMembership
      - `type` 'MEMBERSHIP_PAYMENT_CHARGE', required
      - `id` string, required
      - `shopId` string, required
      - `supporter` ComFourthwallOpenapiModelThankYouContributionSupporter, required
        - `email` string, required
        - `username` string
        - `message` string
    - ComFourthwallOpenapiModelThankYouContributionOrder
      - `type` 'ORDER', required
      - `id` string, required
      - `shopId` string, required
      - `supporter` ComFourthwallOpenapiModelThankYouContributionSupporter, required
        - `email` string, required
        - `username` string
        - `message` string

## Other responses

- `400`: Possible errors: `KUDOS_CONTRIBUTION_IN_INCORRECT_STATE`, `PII_GUARD_INVALID_REQUEST`
- `403`: Possible errors: `PII_GUARD_ACCESS_DENIED`
- `404`: Possible errors: `KUDOS_CONTRIBUTION_DOES_NOT_EXIST`, `PII_GUARD_RECORD_NOT_FOUND`
- `406`: Possible errors: `KUDOS_UNSUPPORTED_MEDIA_TYPE`
- `409`: Possible errors: `KUDOS_THANK_YOU_DUPLICATION`
- `429`: Rate limited: 100 requests / 10 seconds per shop.

## Changes

- **2026-07-21** `d02dd5a76313`: 2 info
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`

[Operation history](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/changes/open-api/v1.0/thank-you-contributions/:id/post.md)

---

[API](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2.md) - [All operations](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/llms.txt) - [OpenAPI document](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/revisions/77de1061d5c9?raw)