postedly_design_postcard
Creates a two-page postcard document without a PDF: the front is a ready-made design, a photo-frame design with the sender's photo placed in its photo area, or a custom front image covering the whole front, and the back carries a typed message that Postedly sets in a fixed typeface in the left column, clear of the address and postage area. Images are JPEG or PNG (PNG at most 4 megapixels; use a JPEG for larger pictures), sent as base64 or as the ID of an image uploaded for a postcard; they are centered and cropped to fill, and images too small for good quality, far from the target shape, or text that does not fit is rejected with a specific error rather than shrunk. Returns a private document ID, page count, SHA-256, an authenticated preview URL, what was composed and the postcard price. Does not create a quote, take payment or send anything.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"message": "<message>"
},
"name": "postedly_design_postcard"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | Plain text for the back, up to 450 characters that must also fit the message area: 15 lines of about 30 characters with a greeting and signature, 18 without. Line breaks are kept and each uses a line. Latin letters, digits and common punctuation; emoji and non-Latin scripts are rejected. | |
| designId | No | Design ID from the postcard product list. A photo-frame design also needs an image. Omit to use the image as the whole front. | |
| greeting | No | Optional opening line above the message, such as Dear Sam, up to 30 characters on one line; wide letters or all capitals fit fewer (LINE_TOO_WIDE). | |
| signature | No | Optional closing line below the message, such as Love, Alex, up to 30 characters on one line; wide letters or all capitals fit fewer (LINE_TOO_WIDE). | |
| imageBase64 | No | Standard padded base64 of a JPEG or PNG, without a data URL prefix: the sender's photo for a photo frame, or the whole front when designId is omitted. The sender's own or licensed image; a generated front is artwork with no words, since Postedly sets the message as type. | |
| imageSha256 | No | Optional SHA-256 of the original image bytes; a mismatch rejects the request. | |
| imageDocumentId | No | ID of a JPEG or PNG already uploaded for a postcard, as an alternative to imageBase64. |