Guider
Send e-post med API-et
E-post går fra en avsender på ditt eget domene. Du setter opp domenet og avsenderen i dashbordet én gang, og sender deretter med ett kall.
Før du sender
- Legg til domenet i dashbordet og sett inn DNS-postene vi viser. Vi sjekker dem for deg.
- Lag en avsender på domenet og få den godkjent. Uten
senderIdsender vi fra profilens standardavsender.
Send en e-post
Send en e-post
curl -X POST "https://api.telkit.no/v1/email" \ -H "Authorization: Bearer $TELKIT_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: ordre-2041-sendt" \ -d '{ "profile": "nettbutikken", "senderId": "0199e4a9-7a5d-7b4e-86f3-bd8e5a9bac43", "to": "kari.nordmann@example.no", "subject": "Ordren din er sendt", "text": "Hei Kari! Ordre 2041 er sendt og kommer i løpet av to dager.", "html": "<p>Hei Kari!</p><p>Ordre 2041 er sendt og kommer i løpet av to dager.</p>"}'const response = await fetch("https://api.telkit.no/v1/email", { method: "POST", headers: { Authorization: `Bearer ${process.env.TELKIT_API_KEY}`, "Content-Type": "application/json", "Idempotency-Key": "ordre-2041-sendt", }, body: JSON.stringify({ profile: "nettbutikken", senderId: "0199e4a9-7a5d-7b4e-86f3-bd8e5a9bac43", to: "kari.nordmann@example.no", subject: "Ordren din er sendt", text: "Hei Kari! Ordre 2041 er sendt og kommer i løpet av to dager.", html: "<p>Hei Kari!</p><p>Ordre 2041 er sendt og kommer i løpet av to dager.</p>", }),});const answer = await response.json();| Felt | Betyr |
|---|---|
to | Én adresse, eller en liste med adresser. Prisen er per mottaker. |
subject | Emnet. |
text | Ren tekst. Påkrevd sammen med emnet. |
html | En HTML-versjon i tillegg til teksten. Valgfri. |
templateId, variables | En e-postmal fra profilen med verdiene som skal fylles inn, i stedet for emne og tekst. |
Prisen per mottaker blir reservert med en gang og trukket når leverandøren har tatt imot e-posten.
Levering
email.status forteller når e-posten er sendt, levert, avvist (bounced), meldt som søppel (complained) eller feilet. Svar som kommer inn på en av adressene dine, kommer som email.received.
Hent én e-post med status
curl "https://api.telkit.no/v1/email/0199e4ac-8b1d-7c5e-97f4-ce9f6bacbd54" \ -H "Authorization: Bearer $TELKIT_API_KEY"const response = await fetch("https://api.telkit.no/v1/email/0199e4ac-8b1d-7c5e-97f4-ce9f6bacbd54", { headers: { Authorization: `Bearer ${process.env.TELKIT_API_KEY}`, },});const answer = await response.json();Kampanjer
En kampanje sender den samme e-posten til mange: kontaktene med e-postadresse i en kontaktgruppe, eller en liste du sender med. Plassholdere som {{fornavn}} fylles ut for hver mottaker. En kontakt i en gruppe gir navn, fornavn og epost. En mottaker i en liste gir sine egne variables.
Se først hva kampanjen koster, og hvor mange mottakere saldoen rekker til:
Regn ut hva en kampanje koster
curl -X POST "https://api.telkit.no/v1/email-campaigns/quote" \ -H "Authorization: Bearer $TELKIT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "profile": "nettbutikken", "subject": "Nytt i butikken i november", "text": "Hei {{fornavn}}! Vi har fått inn vinterjakkene.", "groupId": "0199e4ad-9c2e-7d6f-a8b5-df0a7cbdce65"}'const response = await fetch("https://api.telkit.no/v1/email-campaigns/quote", { method: "POST", headers: { Authorization: `Bearer ${process.env.TELKIT_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ profile: "nettbutikken", subject: "Nytt i butikken i november", text: "Hei {{fornavn}}! Vi har fått inn vinterjakkene.", groupId: "0199e4ad-9c2e-7d6f-a8b5-df0a7cbdce65", }),});const answer = await response.json();Send en kampanje til en kontaktgruppe
curl -X POST "https://api.telkit.no/v1/email-campaigns" \ -H "Authorization: Bearer $TELKIT_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: nyhetsbrev-2026-11" \ -d '{ "profile": "nettbutikken", "name": "Nyhetsbrev november", "subject": "Nytt i butikken i november", "text": "Hei {{fornavn}}! Vi har fått inn vinterjakkene.", "groupId": "0199e4ad-9c2e-7d6f-a8b5-df0a7cbdce65", "scheduledAt": "2026-11-05T09:00:00+01:00"}'const response = await fetch("https://api.telkit.no/v1/email-campaigns", { method: "POST", headers: { Authorization: `Bearer ${process.env.TELKIT_API_KEY}`, "Content-Type": "application/json", "Idempotency-Key": "nyhetsbrev-2026-11", }, body: JSON.stringify({ profile: "nettbutikken", name: "Nyhetsbrev november", subject: "Nytt i butikken i november", text: "Hei {{fornavn}}! Vi har fått inn vinterjakkene.", groupId: "0199e4ad-9c2e-7d6f-a8b5-df0a7cbdce65", scheduledAt: "2026-11-05T09:00:00+01:00", }),});const answer = await response.json();- Når kampanjen starter, blir alle e-postene priset og reservert samlet. Dekker ikke saldoen eller profilens budsjett alt, blir ingen sendt, og kampanjen ender som
refusedmed hvor mange som ville fått plass. - Hver e-post har en lenke for å melde seg av. En adresse som har meldt seg av, blir hoppet over og koster ingenting.
POST /v1/email-campaigns/:id/cancelstopper e-postene som ikke er sendt.