Motives

Upload a temporary custom motive

Uploads one temporary, account-owned postcard motive. The account must be enabled for API custom motives. The front image must be a readable PNG or JPEG file, at most 5 MB, and exactly 1795x1287 pixels for landscape motives or 1287x1795 pixels for vertical motives. An optional custom back side can be uploaded as a separate back_side file when the account has both regular custom back-side bookings active: logo replacement and vertical text replacement. The back side has its own 5 MB limit and must always be exactly 1795x1287 px landscape, independent of orientation, because it is printed full-bleed without rotation. When back_side is present, EchtPost does not render its standard postmark image or footer logo; the uploaded image must include the franking area, dividing line, footer line, and static branding elements, but not recipient address lines because EchtPost prints the actual address. API clients upload artwork and card data, not the final PDF, and are responsible for checking the final print result in the EchtPost web UI during development. Accounts are limited to 1,000 temporary motive uploads per rolling 24 hours; exceeding that limit returns HTTP 429 and notifies support.

post/motives

Request

  • Base URL: https://api.echtpost.de/v2
  • URL: https://api.echtpost.de/v2/motives
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://my.echtpost.de/oauth/authorize, token URL https://my.echtpost.de/oauth/token, scopes: mcp)
    • API key in header X-Api-Key
    • HTTP bearer

Response

Created

idinteger
namestring
descstring nullable
orientation'vertical' | 'landscape'
highlightboolean
content_availableboolean
content_ps_availableboolean
vertical_text_availableboolean
qr_code_availableboolean
has_back_sideboolean

Whether this motive has a custom back-side image attached.

urlstring nullable

Link to the motive page on echtpost.de

preview_image_urlstring uri nullable

URL to a preview image of the motive front (~300-420px). For your own motives this is a signed asset URL that stays valid until the assets are purged (see assets_purged_at), and anyone holding the link can open the image.

back_side_image_urlstring uri nullable

URL to a preview image of the custom back side (~300-420px), or null when the motive has no custom back side. Signed asset URL with the same lifetime as preview_image_url.

tagsstring[]
temporaryboolean
assets_expires_atstring date nullable

Earliest date on which temporary motive assets may be purged. Null for permanent motives or already-purged assets without a pending expiry.

assets_purged_atstring date-time nullable
created_atstring date-time
updated_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.