Postly
Send et brev
Tilbage til API-sidenFuld dokumentation

Kom i gang med Postlys API på 5 minutter

Denne side viser de fem kald, der skal til for at sende dit første brev. Alle endpoints ligger under https://postly.dk/api/public/v1 og svarer med JSON.

1. Hent priser (ingen nøgle krævet)

Dette endpoint er offentligt. Brug det til at bekræfte, at API'et svarer, og til at holde jeres egen prisberegning opdateret.

curl https://postly.dk/api/public/v1/pricing

2. Send dit første brev

Angiv afsender og modtager, vælg brevtype og send enten text eller fileBase64 (en PDF kodet som base64). Beløbet trækkes automatisk fra saldoen, og brevet oprettes som betalt. Idempotency-Key sikrer, at et gentaget kald ikke sender to breve.

curl -X POST https://postly.dk/api/public/v1/letters \
  -H "Authorization: Bearer pk_postly_xxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: ordre-1234" \
  -H "Content-Type: application/json" \
  -d '{
    "letterType": "almindelig",
    "sender": {
      "name": "Eksempel ApS",
      "address": "Nordre Fasanvej 207A",
      "zip": "2000",
      "city": "Frederiksberg"
    },
    "recipient": {
      "name": "Jens Jensen",
      "address": "Vestergade 1",
      "zip": "8000",
      "city": "Aarhus"
    },
    "text": "Kære Jens, her følger ...",
    "reference": "faktura-1234"
  }'

Til en PDF-fil: erstat text med fileBase64 og sæt indholdet af filen som base64. Filer kan maks. fylde 25 MB.

3. Læs svaret

Et vellykket kald returnerer ordren med id og status: "paid". I får samtidig en kvittering på mail. I kan gemme id som jeres ordrestatus hos os.

{
  "id": "...",
  "status": "paid",
  "letterType": "almindelig",
  "pageCount": 2,
  "amountOre": 6900
}

4. Slå status op senere

curl https://postly.dk/api/public/v1/letters/ORDRE_ID \
  -H "Authorization: Bearer pk_postly_xxxxxxxxxxxxxxxx"

Når vi har sendt brevet, får I en mail med ordrenummer og dato.

5. Fyld saldo op

Kaldet returnerer et Stripe-betalingslink. Beløbet lægges på saldoen, når kortbetalingen er gennemført. Mindst 100 kr., maks. 50.000 kr. pr. indbetaling.

curl -X POST https://postly.dk/api/public/v1/topups \
  -H "Authorization: Bearer pk_postly_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "amountOre": 100000 }'

Forbind jeres AI-assistent (MCP)

Samme nøgle giver adgang til Postlys MCP-server, så ChatGPT, Claude eller en anden assistent kan slå priser op, tjekke saldo, sende breve og se status. Værktøjet, der sender breve, er markeret som "ændrer data", så assistenten beder om bekræftelse.

URL:  https://postly.dk/api/public/v1/mcp
Auth: Authorization: Bearer pk_postly_xxxxxxxx

Typiske fejl

Alle fejl kommer som { "error": { "code": "...", "message": "..." } } med en dansk besked.

Reglerne i korte træk

Se fuld dokumentationKontakt os