Sittr API v1

Skicka handskrivna brev direkt från ert CRM

När en affär når rätt steg i HubSpot, Pipedrive eller ert eget system skickar Sittr ett riktigt brev, skrivet med riktig penna. Ett anrop, inga formulär.

Ett anrop per brev

Skicka mottagare, text och avsändare som JSON. Ni får ett ordernummer direkt.

Följ varje brev

Status går från mottaget till skrivet till postat, och vi kan pinga ert system vid varje steg.

Testläge

Med en testnyckel kan ni bygga och prova fritt. Inga brev skickas och inget dras från saldot.

Kom igång

  1. 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.
  2. Skicka nyckeln i varje anrop: Authorization: Bearer <nyckel>. Håll den hemlig, som ett lösenord.
  3. 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

  1. Välj en trigger, till exempel HubSpot: Deal Stage Changed eller Pipedrive: Updated Deal.
  2. Lägg till steget Webhooks by Zapier → Custom Request.
  3. Method: POST. URL: https://sittr.se/api/v1/letters.
  4. Data: klistra in JSON-exemplet ovan och byt ut värdena mot fält från ert CRM (namn, adress, text).
  5. Headers: Authorization = Bearer sittr_live_… och Content-Type = application/json.

Make

Använd modulen HTTP → Make a request med samma adress, metod, headers och JSON-kropp.

Tips: skicka affärens id som 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ältKravBeskrivning
recipient.nameJaMottagarens namn
recipient.titleNejTitel, t.ex. Säljchef
recipient.companyNejFöretag
recipient.address_line1JaGatuadress
recipient.address_line2Nejc/o, våning eller box
recipient.postal_codeJaFem siffror, mellanslag går bra
recipient.cityJaOrt
recipient.countryNejSE (bara Sverige just nu)
messageJaBrevtexten, högst 900 tecken. Radbrytningar följer med.
sender_nameJaNamnet som skrivs under brevet
referenceNejErt 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

AnropVad 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/lettersEra 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/accountBrev kvar i saldot, dagens gräns och hur många ni skickat i dag

Status för ett brev

StatusBetyder
receivedVi har tagit emot beställningen. Den går fortfarande att avbryta.
writtenBrevet är skrivet med penna och kuverterat.
mailedBrevet är lämnat till PostNord.
cancelledBrevet 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.

HTTPKodBetyder
400invalid_jsonKroppen är inte giltig JSON
401unauthorizedNyckeln saknas, är fel eller är avstängd
402no_letters_leftBrevsaldot är slut
404not_foundBrevet eller adressen finns inte
409cannot_cancelBrevet har redan börjat skrivas
422validation_failedEtt eller flera fält är fel, se fields
429daily_limit_reachedDagens gräns är nådd, eller för många anrop per minut

Pris och gränser

Personuppgifter. När ni skickar mottagaruppgifter till oss behandlar vi dem för er räkning och bara för att skriva och posta brevet. Läs mer i vår integritetspolicy. Biträdesavtal skickar vi gärna, mejla hej@sittr.se.
Använder ni Claude eller en annan AI-agent? Koppla Sittr via vår MCP-server. Agenten skriver utkastet och ni godkänner varje brev i chatten.

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.