Send breve fra Zapier, Make og n8n
Postlys API sender et brev med ét kald. Alle tre værktøjer har et HTTP-trin, så I behøver ingen særlig app: samme URL, de samme headers og den samme JSON. Brevet betales fra jeres forudbetalte saldo og afleveres til dao samme hverdag, hvis det er bestilt før kl. 12.
Det skal I bruge
- En erhvervskonto og en API-nøgle fra /konto/api. Prøv først med en testnøgle (
pk_test_postly_): testbreve bliver aldrig printet, sendt eller trukket fra saldoen. - Modtagerens navn, adresse, postnummer og by fra jeres trigger.
- Brevets tekst, eller en PDF som base64 i
fileBase64medfileName.
Kaldet
POST https://postly.dk/api/public/v1/lettersAuthorization: Bearer pk_live_postly_...
Content-Type: application/json
Idempotency-Key: {{ordrenummer}}{
"letterType": "almindelig",
"sender": {
"name": "Eksempel ApS",
"address": "Nordre Fasanvej 207A",
"zip": "2000",
"city": "Frederiksberg"
},
"recipient": {
"name": "{{navn}}",
"address": "{{adresse}}",
"zip": "{{postnummer}}",
"city": "{{by}}"
},
"text": "{{brevtekst}}",
"reference": "{{ordrenummer}}"
}Brug et ordrenummer eller et andet fast id som Idempotency-Key. Kører trinnet igen med samme nøgle, sender vi ikke brevet to gange.
Zapier
- Tilføj et trin med appen "Webhooks by Zapier" og handlingen "Custom Request".
- Method: POST. URL: https://postly.dk/api/public/v1/letters.
- Data: JSON-eksemplet herunder, hvor felterne i {{ }} kobles til data fra jeres trigger.
- Headers: de tre headers herunder.
Make
- Tilføj modulet "HTTP" med handlingen "Make a request".
- URL: https://postly.dk/api/public/v1/letters. Method: POST.
- Headers: de tre headers herunder. Body type: Raw, content type JSON.
- Request content: JSON-eksemplet herunder med jeres felter fra de forrige moduler.
n8n
- Tilføj noden "HTTP Request".
- Method: POST. URL: https://postly.dk/api/public/v1/letters.
- Authentication: "Generic Credential Type", "Header Auth" med navnet Authorization og værdien "Bearer pk_live_postly_...".
- Send Body: JSON. Indsæt eksemplet herunder, og skift {{ }} ud med udtryk fra de forrige noder, fx {{ $json.navn }}.
Alle felter, svar og fejlkoder står i API-dokumentationen.