---
title: "Greeting card by post: donations with the Charitips API"
description: "A company orders a year-end card for each client: Charitips prints and posts it with a 25 € gift, and the client picks the charity online. The sender pays."
canonical: https://www.charitips.com/docs/use-cases/delivered-gift/posted-card
---

# Greeting card by post: donations with the Charitips API

> A company orders a year-end card for each client: Charitips prints and posts it with a 25 € gift, and the client picks the charity online. The sender pays.

- **Use case**: [A gift sent by email, Slack or post](https://www.charitips.com/docs/use-cases/delivered-gift.md)
- **Sector**: Professional services
- **Who pays**: Your company
- **What starts the donation**: A customer action
- **Example**: A year-end card with a 25 € gift, posted to each client
- **Calls**: [`POST /v1/charities-selections`](https://www.charitips.com/docs/api-reference/create-charities-selection.md), [`POST /v1/campaigns`](https://www.charitips.com/docs/api-reference/create-campaign.md), [`POST /v1/campaigns/{campaignId}/activate`](https://www.charitips.com/docs/api-reference/activate-campaign.md), [`POST /v1/donations`](https://www.charitips.com/docs/api-reference/create-donation.md)
- **Webhooks**: `donation_create`, `donation_update`

Interactive demo on the page. The same flow as a build spec: https://www.charitips.com/docs/demos/delivered/posted-card.md

## How it works

The screens of the demo in order, with the calls your server makes at each one.

### Once, before the first customer

- [`POST /v1/charities-selections`](https://www.charitips.com/docs/api-reference/create-charities-selection.md) Create a charities selection: once: the charities you offer, from the catalog

  ```json
  {
    "name": "Year-end cards",
    "charityIds": [
      "<charityId>"
    ]
  }
  ```
- [`POST /v1/campaigns`](https://www.charitips.com/docs/api-reference/create-campaign.md) Create a campaign: once: the campaign the donations go to

  ```json
  {
    "name": "Year-end cards",
    "charitiesSelectionId": "<charitiesSelectionId>",
    "type": "PERMANENT",
    "amountType": "FREE_AMOUNT",
    "sendingMode": "POSTAL",
    "momentSlug": "cadeau-client-fin-d-annee"
  }
  ```
- [`POST /v1/campaigns/{campaignId}/activate`](https://www.charitips.com/docs/api-reference/activate-campaign.md) Activate a campaign: once: the campaign starts taking donations

### 1. When the card is scheduled

- Button: Post Camille's card

**Your server calls:**

- [`POST /v1/donations`](https://www.charitips.com/docs/api-reference/create-donation.md) Create a donation: from your server, when it happens; amount in cents

  ```json
  {
    "campaignId": "<campaignId>",
    "amount": 2500,
    "uniqueExternalId": "year_end_card_2026_client_0412",
    "externalId": "client_contact_0412",
    "donor": {
      "firstName": "Camille",
      "lastName": "Martin",
      "companyName": "Architects' office",
      "street": "12 rue des Lilas",
      "zip": "69003",
      "city": "Lyon",
      "country": "FR"
    },
    "sendingDate": "2026-12-14"
  }
  ```

Charitips then sends the `donation_create` webhook to your endpoint.

### 2. At the posting batch

- Button: Run the 16:00 batch

No call: this screen only shows the result.

Charitips then sends the `donation_update` webhook to your endpoint.

### 3. On the choice, on the Charitips page

- The customer picks a charity from your selection.
- Button: Choose the charity

No call: this screen only shows the result.

Charitips then sends the `donation_update` webhook to your endpoint.

## Other ways to run it

- [Graduation gift](https://www.charitips.com/docs/use-cases/delivered-gift/graduation-gift.md) (Education): 5 € for each graduate, sent on ceremony day
- [Secure merge, on Slack](https://www.charitips.com/docs/use-cases/delivered-gift/secure-merge.md) (Software and apps): 5 € for each merge request with no critical flaw
- [Audit report delivered](https://www.charitips.com/docs/use-cases/delivered-gift/audit-report.md) (Professional services): 50 € when the final report is signed
- [Property estimate sent](https://www.charitips.com/docs/use-cases/delivered-gift/property-estimate.md) (Professional services): 0,1 % of the estimated value
- [API usage milestone](https://www.charitips.com/docs/use-cases/delivered-gift/usage-milestone.md) (Software and apps): 10 € in the client's name at each milestone
- [Upsell signed](https://www.charitips.com/docs/use-cases/delivered-gift/upsell-signed.md) (Software and apps): 5 % of the upsell, offered to the client
- [Gift after an event](https://www.charitips.com/docs/use-cases/delivered-gift/event-goodies.md) (Culture and events): 1 € to 5 € per visitor, sent by email
- [Greeting card with a gift](https://www.charitips.com/docs/use-cases/delivered-gift/card-gift.md) (Retail): 5 € in each business card, sent when it ships
- [Client gift as a donation](https://www.charitips.com/docs/use-cases/delivered-gift/corporate-gift.md) (Professional services): A 50 € client gift, turned into a donation
- [Full guide: edge cases, webhooks, receipts](https://www.charitips.com/docs/use-cases/delivered-gift.md)
- [All use cases](https://www.charitips.com/docs/use-cases.md)