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

Kaldet

POST https://postly.dk/api/public/v1/letters
Authorization: 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

  1. Tilføj et trin med appen "Webhooks by Zapier" og handlingen "Custom Request".
  2. Method: POST. URL: https://postly.dk/api/public/v1/letters.
  3. Data: JSON-eksemplet herunder, hvor felterne i {{ }} kobles til data fra jeres trigger.
  4. Headers: de tre headers herunder.

Make

  1. Tilføj modulet "HTTP" med handlingen "Make a request".
  2. URL: https://postly.dk/api/public/v1/letters. Method: POST.
  3. Headers: de tre headers herunder. Body type: Raw, content type JSON.
  4. Request content: JSON-eksemplet herunder med jeres felter fra de forrige moduler.

n8n

  1. Tilføj noden "HTTP Request".
  2. Method: POST. URL: https://postly.dk/api/public/v1/letters.
  3. Authentication: "Generic Credential Type", "Header Auth" med navnet Authorization og værdien "Bearer pk_live_postly_...".
  4. 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.