E-mail verzenden API: Verzenden vanaf gebruiker Gmail, Outlook & IMAP Rekeningen
De meeste e-mail-API's verzenden vanaf een gedeeld domein dat u bezit. De send email API van Unipile is anders: deze verzendt vanuit de eigen Gmail-, Outlook- en IMAP-accounts van uw gebruikers, met volledige OAuth2, geen opslag van inloggegevens en één uniform eindpunt voor elke provider. Wanneer uw SaaS namens echte mensen programmatisch e-mail moet versturen, is dit de integratie die ervoor zorgt dat het werkt.
Een E-mail Verzenden API die namens uw gebruikers handelt
De meeste zoekopdrachten naar "e-mail verzenden API" leiden naar transactionele providers. Dat is dit niet. Unipile is een e-mail API voor gebruikersaccounts: het maakt verbinding met de echte Gmail- of Outlook-accounts van uw gebruikers en verzendt namens hen, met hun identiteit en hun afleverbaarheid.
Waarom ontwikkelaars bouwen op een e-mail-API voor gebruikersaccounts
Wanneer uw product programmatisch e-mails moet versturen namens echte personen (niet een noreply@ adres), zijn dit de scenario's die adoptie stimuleren.
Stuur vervolgmails vanuit het eigen Gmail- of Outlook-account van elke vertegenwoordiger. Hogere responspercentages, authentieke afzenderidentiteit, geen domein-warming vereist. Prospects zien een echte naam, geen algemene alias.
Laat ondersteuningsmedewerkers rechtstreeks vanuit hun eigen mailbox antwoorden. Klanten zien de naam en het e-mailadres van een echt persoon, niet een support@ alias. Dit bouwt vertrouwen op en versnelt de oplossing.
Bereik kandidaten met gepersonaliseerde e-mails vanuit het daadwerkelijke account van de recruiter. Geen koude domeinen, geen risico op spamfilters, geen opwarmperiode. De e-mail komt in de inbox aan als een persoonlijke boodschap, omdat het ook zo is.
E-mail verzenden vanuit Gmail, Outlook en IMAP: één API
De send email API van Unipile abstraheert de providerlaag volledig. Of het account van uw gebruiker nu Gmail, Outlook, Microsoft 365, Exchange Online of een andere IMAP-compatibele mailbox is, de API-aanroep is identiek. U schrijft de integratie één keer en iedere provider werkt gewoon.
gmail.verzendenminimale permissievoetafdruk Mail.verzenden: gedelegeerd of app-niveau E-mail verzenden via API: Stap-voor-stap integratie
Van accountkoppeling tot het programmatisch verzenden van je eerste e-mail, hier is de complete workflow. Deze gids behandelt Gmail en Outlook; de stappen voor IMAP zijn identiek, alleen het accounttype verschilt.
Meld u aan in het Unipile-dashboard. Elke werkruimte krijgt een API-sleutel. Alle verzoeken worden geauthenticeerd met de X-API-KEY header. Geen OAuth-instellingen aan uw kant: Unipile regelt de authenticatie van de provider voor u.
Genereer een gehoste autorisatielink via de API. De gebruiker klikt erop en doorloopt het standaard OAuth2-toestemmingsscherm van hun provider. Unipile slaat de tokens veilig op en retourneert een account_id. U raakt nooit inloggegevens aan.
"type":"MICROSOFT". Voor IMAP, gebruik "type":"IMAP". Dezelfde gehoste flow handelt alle drie de providers af.Nadat de gebruiker OAuth2 heeft voltooid, stuurt Unipile een webhook naar uw eindpunt met de account_id. Sla het op in je database: het is de sleutel die je bij elke API-aanroep voor het verzenden van e-mails voor die gebruiker zult gebruiken.
POST naar /api/v1/emails met de account_id. De e-mail wordt verzonden vanuit de daadwerkelijke Gmail- of Outlook-inbox van de gebruiker, net alsof de gebruiker zelf op verzenden heeft geklikt. Het eindpunt is identiek, ongeacht of het gekoppelde account Gmail, Outlook of IMAP is.
"cc", "bl", "antwoord_aan"en "bijlagen" naar dezelfde lading.Klaar om e-mails te verzenden vanuit Gmail, Outlook en IMAP?
Uw API-sleutel wacht. Begin binnen 10 minuten met bouwen.
Eén Uniform Eindpunt om E-mails te Verzenden via Alle Providers
De grootste wrijving bij integraties met meerdere providers is het onderhouden van aparte code paden voor elke e-maildienst. Unipile elimineert dat. Of het gekoppelde account nu Gmail, Outlook of IMAP is, je roept altijd dezelfde endpoint aan met dezelfde payload. De abstractielaag regelt provider-specifieke protocollen, token-vernieuwingen en verschillen in snelheidslimieten achter de schermen.
Geen aparte code paden voor Gmail versus Outlook. Eén integratie dekt vandaag alle drie de providers en eventuele toekomstige toevoegingen die Unipile doet.
OAuth2 toegangstokens verlopen. Unipile ververst ze transparant. Je code hoeft nooit de levenscyclus van tokens af te handelen; roep gewoon de API aan en verzend.
Elke gebruiker koppelt zijn eigen account. U beheert een account_id per gebruiker; Unipile regelt de rest. Geen gedoe met SDK's per provider.
De API retourneert dezelfde JSON-structuur, ongeacht de provider. Parse één schema, bouw één foutafhandeling, lever sneller.
E-mails op schaal namens uw gebruikers verzenden? Lees de volledige gids over hoe u dat doet e-mails namens uw gebruikers versturen, inclusief het compliancie- en toestemmingsmodel dat Unipile gebruikt om alles controleerbaar te houden.
Alle API-eindpunten voor e-mail verzenden, georganiseerd
Elk eindpunt beschikbaar voor het verbinden van accounts, het verzenden en beantwoorden, het beheren van uw mailbox en het luisteren naar gebeurtenissen op Gmail, Outlook en IMAP met één enkele integratie.
Verzenden en beantwoorden
4 eindpunten beschikbaar
Accountinstelling
3 eindpunten beschikbaar
E-mails beheren
5 eindpunten beschikbaar
Webhooks
2 beschikbare evenementen
Behandelt authenticatiestromen, webhook-instellingen, het lezen en verzenden van e-mails, bijlagen en volledige providervergelijkingen, alles wat u nodig hebt om een productieklaar API-integratie voor het verzenden van e-mail te bouwen.
Authenticatie en Beveiliging voor uw E-mail Verzenden API-integratie
Het verwerken van gebruikers e-mailgegevens is een van de meest risicovolle onderdelen van elke SaaS-integratie. De architectuur van Unipile is zo ontworpen dat u nooit OAuth2-tokens direct opslaat of verzendt; het risicooppervlak blijft minimaal en de naleving blijft beheersbaar.
Unipile genereert de OAuth2 toestemmings-URL, verzamelt de autorisatiecode en slaat de toegangs- en vernieuwingstokens op in zijn eigen versleutelde kluis. Je backend ziet alleen een account_id. Geen ruwe tokens, geen wachtwoorden, geen credential drift.
Gmail OAuth2-tokens verlopen na 1 uur. Microsoft-tokens verlopen na 1 uur (toegang) of 90 dagen (verversen). Unipile ververst deze automatisch vóór het verlopen. Uw API-aanroepen voor het verzenden van e-mails mislukken nooit vanwege een verlopen token.
Voor een alleen-verzenden-integratie vraagt Unipile alleen de vereiste scopes aan: gmail.verzenden voor Gmail en Mail.verzenden voor Outlook. Dit volgt het principe van minimale privileges en verkleint het aanvalsoppervlak voor de gegevens van uw gebruikers.
Elke webhook die Unipile naar uw eindpunt stuurt, bevat een handtekeningheader die u kunt verifiëren tegen uw webhookgeheim. Dit zorgt ervoor dat gebeurtenis-payloads niet kunnen worden vervalst door derden die proberen acties in uw systeem te activeren.
De infrastructuur van Unipile is SOC 2 Type II gecertificeerd. Gecontroleerde controles omvatten toegangsbeheer, encryptie van gegevens in rust en tijdens transport, respons op incidenten en beschikbaarheid. Dit maakt het eenvoudig om leveranciersbeveiligingsbeoordelingen te doorstaan wanneer uw SaaS-klanten vragen hoe u met hun e-mailgegevens omgaat.
Leer over de veilige e-mail APIUnipile is CASA Tier 2 beoordeeld, de beveiligingsstandaard die Google vereist voor applicaties die toegang hebben tot gevoelige Gmail API-scopes. De beoordeling wordt uitgevoerd door een geautoriseerd laboratorium en omvat gegevensverwerking, toegangscontroles en veilige ontwikkelingspraktijken. Vereist om productie-toegang tot Gmail-verzendscopes te behouden.
Volledige E-mail API Functiedekking voor Alle Providers
Eén integratie geeft je toegang tot elke belangrijke e-mailbewerking van Gmail, Outlook en IMAP-providers. Hetzelfde eindpunt, dezelfde payloadstructuur, hetzelfde responsformaat, ongeacht welk account je gebruiker heeft verbonden.
| Functie | Gmail | Outlook / M365 | IMAP / SMTP |
|---|---|---|---|
| Verzenden | |||
| E-mail verzenden vanuit gebruikersaccount | ✓ | ✓ | ✓ |
| Verzenden met bijlagen | ✓ | ✓ | ✓ |
| Reageer in bestaande thread | ✓ | ✓ | ✓ |
| CC en BCC-ontvangers | ✓ | ✓ | ✓ |
| HTML body inhoud | ✓ | ✓ | ✓ |
| Inline afbeeldingen (CID-embedding) | ✓ | ✓ | ✓ |
| Dagelijks verzendlimiet (ongeveer.) | ~500 / dag | ~10.000 / dag | Serverafhankelijk |
| Lezen & Synchroniseren | |||
| E-mails weergeven en lezen | ✓ | ✓ | ✓ |
| Thread / gespreksweergave | ✓ | ✓ | ✓ |
| Realtime webhooks (nieuwe e-mail, gelezen, verzonden) | ✓ | ✓ | ✓ |
| Incrementele delta-synchronisatie | ✓ | ✓ | ✓ |
| Label- en mapbeheer | ✓Labels | ✓Mappen | ✓Mappen |
| Authenticatie & Beveiliging | |||
| OAuth2 (geen wachtwoordopslag) | ✓ | ✓ | App-wachtwoord |
| Automatische tokenvernieuwing | ✓ | ✓ | ✓ |
| SOC 2 Type II / CASA Tier 2 | ✓ | ✓ | ✓ |
Veelgemaakte Fouten bij het Bouwen van een Send Email API Integratie
De meeste problemen die ontwikkelaars tegenkomen bij het integreren van een API voor het verzenden van gebruikersaccount-e-mails vallen in een klein aantal categorieën. Hier zijn degenen die nuttig zijn om te weten voordat u begint met bouwen.
Gmail persoonlijke accounts zijn beperkt tot ongeveer 500 e-mails per dag. Outlook-accounts hebben hogere limieten, maar kunnen nog steeds worden beperkt onder piekperiodes. Het overschrijden van deze limieten resulteert in 429-fouten of tijdelijke accountschorsing door de provider.
Gebruikers kunnen de toegang op elk moment intrekken via de instellingen van hun Google- of Microsoft-account. Wanneer dit gebeurt, retourneert Unipile een fout bij de volgende API-aanroep voor dat account. Als uw applicatie dit niet goed afhandelt, leidt dit tot stilzwijgende e-mailbezorgingsfouten.
account.verbroken webhook-gebeurtenis en de gebruiker vragen om hun account opnieuw te koppelen.Zelfs met een geldig OAuth2-token schendt het verzenden van e-mails vanuit een gebruikersaccount zonder hun medeweten de gebruiksbeleidsregels van Google en Microsoft en de spamberzorgingswetten in de meeste rechtsgebieden. Het OAuth2-toestemmingsscherm moet duidelijk uitleggen wat uw toepassing zal doen.
Als u toegangstokens zelf opslaat en deze worden blootgesteld tijdens een datalek, heeft een aanvaller volledige toegang tot alle gekoppelde e-mailaccounts. Dit is een kritiek beveiligings- en nalevingsrisico, zeker onder de AVG.
account_id; Unipile bewaart de tokens in zijn SOC 2-gecertificeerde kluis. Je database komt nooit in aanraking met een ruwe OAuth2-token.SMTP vereist directe servertoegang, credentialbeheer, TLS-configuratie en afhandeling van bounces. Een REST send email API abstraheert dit allemaal. Het combineren van beide benaderingen in dezelfde codebase voegt complexiteit toe zonder voordeel.
Veelgestelde vragen
Alles wat u moet weten over de send email API.
account_id via webhook. Je stuurt dan een POST naar /api/v1/emails met dat account_id en uw berichtinhoud. De e-mail wordt verzonden vanaf hun daadwerkelijke Gmail-adres. Geen Gmail API-sleutelinstallatie aan uw kant vereist.Mail.verzenden gedelegeerde toestemming. Unipile handelt tokenvernieuwing automatisch af.https://www.googleapis.com/auth/gmail.send. Dit maakt het verzenden van e-mails mogelijk, maar biedt geen toegang tot het lezen, wijzigen of verwijderen van berichten. Wanneer u Unipile gebruikt, configureert u dit bereik niet zelf; de gehoste authenticatiestroom regelt dit. Voor een puur "e-mail verzenden" API-gebruiksscenario, gmail.verzenden is voldoende.POST /api/v1/e-mails het eindpunt beheert Gmail-, Outlook- en IMAP-accounts. De provider wordt bepaald door account_id in de payload; je hoeft het niet te specificeren. Schrijf je verzendlogica één keer en deze werkt, ongeacht welke e-mailprovider je gebruiker heeft gekoppeld.Heb je nog vragen? Ons team staat klaar om te helpen.
Verbind uw eerste Gmail-, Outlook- of IMAP-account en verstuur uw eerste e-mail programmatisch in minder dan 30 minuten. Geen opslag van inloggegevens, geen OAuth2-configuratie aan uw kant, geen SDK per provider. Eén account_id, één REST-endpoint, alle providers.