Skicka mottagare, text och avsändare som JSON. Ni får ett ordernummer direkt.
Status går från mottaget till skrivet till postat, och vi kan pinga ert system vid varje steg.
Med en testnyckel kan ni bygga och prova fritt. Inga brev skickas och inget dras från saldot.
Få en testnyckel direkt
Gratis. Med testnyckeln kan ni prova hela flödet, men inga brev skrivs eller skickas.
Kom igång
- Skapa en testnyckel (
sittr_test_…) ovan. När ni vill köra skarpt skapar ni ett konto och hämtar er livenyckel (sittr_live_…) direkt efter betalningen. - Skicka nyckeln i varje anrop:
Authorization: Bearer <nyckel>. Håll den hemlig, som ett lösenord. - Skicka ert första brev:
curl https://sittr.se/api/v1/letters \
-H "Authorization: Bearer sittr_test_..." \
-H "Content-Type: application/json" \
-d '{
"recipient": {
"name": "Anna Svensson",
"title": "Säljchef",
"company": "Exempel AB",
"address_line1": "Storgatan 1",
"postal_code": "111 22",
"city": "Stockholm"
},
"message": "Hej Anna! Tack för ett bra samtal i dag. Jag skickar förslaget på fredag.",
"sender_name": "Daniel",
"reference": "hubspot-deal-48213"
}'
Svaret kommer direkt:
{
"id": "ST-API-7KQ2MD",
"object": "letter",
"status": "received",
"test": true,
"reference": "hubspot-deal-48213",
"created_at": "2026-11-02T09:14:03.120Z",
...
}
Zapier och Make, utan kod
Ni behöver inte vara utvecklare. Alla verktyg som kan skicka en webhook kan beställa ett brev.
Zapier
- Välj en trigger, till exempel HubSpot: Deal Stage Changed eller Pipedrive: Updated Deal.
- Lägg till steget Webhooks by Zapier → Custom Request.
- Method:
POST. URL:https://sittr.se/api/v1/letters. - Data: klistra in JSON-exemplet ovan och byt ut värdena mot fält från ert CRM (namn, adress, text).
- Headers:
Authorization=Bearer sittr_live_…ochContent-Type=application/json.
Make
Använd modulen HTTP → Make a request med samma adress, metod, headers och JSON-kropp.
reference och sätt headern Idempotency-Key till samma id. Om Zapier eller Make försöker igen skickas brevet ändå bara en gång.Skicka ett brev
POST/api/v1/letters
| Fält | Krav | Beskrivning |
|---|---|---|
recipient.name | Ja | Mottagarens namn |
recipient.title | Nej | Titel, t.ex. Säljchef |
recipient.company | Nej | Företag |
recipient.address_line1 | Ja | Gatuadress |
recipient.address_line2 | Nej | c/o, våning eller box |
recipient.postal_code | Ja | Fem siffror, mellanslag går bra |
recipient.city | Ja | Ort |
recipient.country | Nej | SE (bara Sverige just nu) |
message | Ja | Brevtexten, högst 900 tecken. Radbrytningar följer med. |
sender_name | Ja | Namnet som skrivs under brevet |
reference | Nej | Ert eget id, t.ex. affärens id i CRM:et |
Headern Idempotency-Key är frivillig. Samma nyckel två gånger ger samma brev tillbaka i stället för ett nytt.
Andra anrop
| Anrop | Vad det gör |
|---|---|
GET/api/v1/letters/{id} | Hämtar ett brev och dess status. Brev beställda via MCP har även approval med användarens godkännande ordagrant, tidpunkt och agentnyckelns namn. |
GET/api/v1/letters | Era senaste brev, nyast först (?limit=1–100) |
DELETE/api/v1/letters/{id} | Avbryter ett brev som inte börjat skrivas. Brevet läggs tillbaka i saldot. |
GET/api/v1/account | Brev kvar i saldot, dagens gräns och hur många ni skickat i dag |
Status för ett brev
| Status | Betyder |
|---|---|
received | Vi har tagit emot beställningen. Den går fortfarande att avbryta. |
written | Brevet är skrivet med penna och kuverterat. |
mailed | Brevet är lämnat till PostNord. |
cancelled | Brevet avbröts och drogs inte från saldot. |
Webhooks
Ge oss en adress så skickar vi en POST varje gång ett brev byter status. Då kan ert CRM till exempel logga "Handskrivet brev postat" på affären.
{
"event": "letter.updated",
"created_at": "2026-11-03T15:02:11.000Z",
"data": { "id": "ST-API-7KQ2MD", "status": "mailed", "reference": "hubspot-deal-48213", ... }
}
Varje anrop har headern X-Sittr-Signature: sha256=<hex>, en HMAC-SHA256 av hela kroppen med er webhook-hemlighet (whsec_…). Räkna ut samma värde och jämför för att veta att anropet kommer från oss.
Felkoder
Fel kommer alltid som {"error": {"code": "...", "message": "..."}}. Vid valideringsfel finns även fields med ett meddelande per fält.
| HTTP | Kod | Betyder |
|---|---|---|
| 400 | invalid_json | Kroppen är inte giltig JSON |
| 401 | unauthorized | Nyckeln saknas, är fel eller är avstängd |
| 402 | no_letters_left | Brevsaldot är slut |
| 404 | not_found | Brevet eller adressen finns inte |
| 409 | cannot_cancel | Brevet har redan börjat skrivas |
| 422 | validation_failed | Ett eller flera fält är fel, se fields |
| 429 | daily_limit_reached | Dagens gräns är nådd, eller för många anrop per minut |
Pris och gränser
- Samma pris som i tilläggen: 99 kr per brev inklusive porto, 89 kr från brev 25 och 79 kr från brev 100 under samma månad. Kortet dras när brevet beställs, och nekas kortet svarar API:t med
402och skapar inget brev. Testnycklar kostar aldrig något. Äldre konton med förbetalt saldo ser saldot iGET /api/v1/account. - Vi skriver och postar inom två arbetsdagar.
- Varje nyckel har en dagsgräns (normalt 20 brev per dag) så att ett fel i en automation inte skickar hundratals brev. Behöver ni mer? Hör av er.
- Max 120 anrop per minut.
För AI-agenter och verktyg: OpenAPI 3.1, dokumentationen som Markdown och llms.txt.
Frågor om API:t? Mejla hej@sittr.se, så svarar vi samma dag.