Pingen icon

Pingen

Send physical postal letters through the Pingen API — invoices, reminders, contracts, any PDF.

Actions18

Batch → Send

AI-generated

Summary

Send a created Pingen batch for the selected organisation. Choose one or more country and delivery product pairs, then set the batch’s print mode and colour or grayscale spectrum.

Inputs

  • Environment — Pingen environment and matching credentials to use: Production (default) or Staging, which is described as a free test environment where no real letters are sent.
  • Organisation Name or ID (required) — The Pingen organisation that owns the batch; select it from the loaded options or provide its ID.
  • Batch ID (required) — ID of the batch to send, such as the UUID returned when it was created.
  • Delivery Products (required) — Add one or more country and delivery product pairs. Country is an ISO 3166-1 alpha-2 code (default CH); available products are cheap, fast, registered, bulk, and premium. The operation uppercases and validates each country code and requires at least one complete pair.
  • Print Mode — Simplex (single-sided, default) or duplex (double-sided).
  • Print Spectrum — Grayscale (default) or colour printing.

Output shape

A single JSON object containing the batch response, with JSON:API data flattened into its id, type, and attributes.

The operation sends a PATCH request to Pingen. With Continue On Fail enabled, a failed item returns an error object and may include a statusCode.

Links

Discussion