Mailtrap Inbound
Receive messages in Kurrier through Mailtrap's Inbound Email API.
Mailtrap Inbound
The Mailtrap Inbound integration receives email through Mailtrap's Inbound Email API. Mailtrap notifies Kurrier by webhook, and Kurrier retrieves, parses, and stores the message in the matching identity's mailbox.
Mailtrap Inbound is receive-only in Kurrier. Configure a separate sending provider if the identity must also send mail.
Before you begin
You need:
- A Mailtrap account with an inbound inbox
- Permission to manage Mailtrap webhooks and API tokens
- Workspace owner or administrator access in Kurrier
1. Copy the webhook URL from Kurrier
Open Settings → Providers → Mailtrap Inbound and copy the generated Webhook URL.
It will look similar to:
https://YOUR_KURRIER_HOST/api/v1/hooks/mailtrap/PROVIDER_IDAlways copy the complete value from Kurrier rather than constructing it manually.
2. Create the Mailtrap webhook
- Sign in to the Mailtrap dashboard.
- Open the webhook settings for your inbound configuration.
- Create a webhook using the URL copied from Kurrier.
- Save it and copy the generated signing secret.
Kurrier uses this secret to verify that webhook requests were sent by Mailtrap.
3. Create or copy an API token
In Mailtrap, open Settings → API Tokens and create or copy a token that can access the relevant inbound inbox.
Kurrier uses the token to retrieve the message after receiving a webhook notification.
4. Save the credentials in Kurrier
Return to the Mailtrap provider in Kurrier and select Edit Credentials.
Enter:
| Field | Value |
|---|---|
| Mailtrap API token | The API token created in Mailtrap |
| Mailtrap webhook secret | The signing secret generated for the webhook |
Save the provider, then select Test Connection.
Test Connection validates the API token. The webhook secret is validated only when Kurrier receives a signed webhook request. Use Mailtrap's webhook test or send a real message to test the complete flow.
5. Add receiving identities
Kurrier files a message by matching its recipient address to an identity in your workspace.
- Select Add Identity from the Mailtrap provider.
- Enter the address assigned by Mailtrap, or an address configured to forward into the Mailtrap inbox.
- Repeat this for every recipient address you expect Kurrier to accept.
If no identity matches the recipient, Kurrier cannot determine which mailbox should receive the message.
Troubleshooting
| Problem | What to check |
|---|---|
Webhook test returns 401 | Re-copy the signing secret from the same Mailtrap webhook and save it again in Kurrier. |
Webhook test returns 404 | Re-copy the complete webhook URL from the provider card. |
| Test Connection fails | Confirm that the API token is active and can access the inbound inbox. |
| Mail reaches Mailtrap but not Kurrier | Add a Kurrier identity matching the message's recipient address exactly. |
| Mailtrap cannot save the webhook | Confirm that the URL was copied completely and uses HTTPS. |
Do not share Mailtrap tokens or webhook secrets with Kurrier Support. If a credential may have been exposed, rotate it in Mailtrap and update the provider in Kurrier.