REST API

Use cases

• Send password resets, payment receipts and OTPs from your backend
• Trigger service confirmations and status updates from any language or framework
• Queue and batch thousands of citizen notices from your own workers

What you can do today

1. 1
   Create an API key

   In the dashboard, open API keys and create a key with the emails:send scope. Copy the tfm_k_live_ secret once.

2. 2
   POST to /v1/emails/

   Call https://govconnect.ke/v1/emails/ with an Authorization: Bearer tfm_k_live_... header and a JSON body (from, to, subject, html).

3. 3
   Check the response

   You get back an email id. Poll /v1/emails/{id} or wire a webhook to follow delivery.