API v1

PostBuddy API

Send printed mail from your own software. Create items, follow their status and receive webhooks when they reach PostNL.

https://api.postbuddy.nl/v1
Create an item
curl -X POST https://api.postbuddy.nl/v1/postflows/pf_01J9Y2K8QF4T6W8Z0B2D4F6H8K/items \
  -H "Authorization: Bearer $POSTBUDDY_API_KEY" \
  -H "Idempotency-Key: crm-0062p00001Xyz-signed" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": {
      "name": "Sanne de Vries",
      "addressLine1": "Oudegracht 112",
      "postalCode": "3511 AX",
      "city": "Utrecht",
      "country": "NL"
    },
    "variables": {
      "first_name": "Sanne"
    }
  }'

PostBuddy sends printed postcards and letters through an API: you keep templates with variables, hand us recipients and variables per item, and the platform renders, prints and posts. This site covers the public API (/v1), the SDKs for TypeScript and Python, webhooks and the error codes.

Start here