bulk_send
Send identical postcards to multiple recipients simultaneously using one message, image, and return address, with automatic refunds for failed deliveries.
Instructions
Send the same postcard to multiple recipients at once. Same message, image, and return address for all cards — only the recipient addresses differ. Maximum 500 recipients per request. Total cost is deducted upfront from balance; failed cards are automatically refunded. Volume pricing applies based on your tier.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| recipients | Yes | Array of recipient addresses (max 500) | |
| from | Yes | Sender (return) address — same for all postcards | |
| message | Yes | Message text for the back of every postcard (max 350 characters) | |
| image_url | Yes | URL of the image for the front of every postcard. Must be publicly accessible HTTPS URL. Recommended minimum resolution: 1875x1275 pixels. |