Postmark integration with Espo

[Matt Barnez]

Hi,

I’m trying to integrate Postmark with EspoCRM.

We already use Postmark for sending emails, but we would also like to receive Postmark tracking data inside EspoCRM, including:

• Email delivery status
• Bounces
• Opens
• Link clicks
• Other Postmark webhook events

I understand that EspoCRM does not currently have a built-in Postmark integration.

What would be the best way to connect Postmark and EspoCRM?

Can this be done using Postmark Webhooks and the EspoCRM REST API?

If so, is there any existing example, extension, or recommended approach for implementing this?

Our goal is to associate Postmark email events with the corresponding contacts/leads and emails inside EspoCRM.

Thanks for your help.

[eymen-elkum]

Yes, Postmark Webhooks with an EspoCRM API endpoint would be the right approach.

I would implement it like this:

- Add a custom EspoCRM endpoint to receive Postmark webhook events.
- Enable the Delivery, Bounce, Open and Click webhooks in Postmark.
- Include the EspoCRM Email record ID as Postmark metadata when sending the email.
- Use that ID from the webhook payload to link each event to the correct Email record.
- Store the events in a custom entity linked to Email, Contact or Lead.

If you send through SMTP, Postmark metadata can be added with a header such as:

X-PM-Metadata-espo-email-id: EMAIL_RECORD_ID

The webhook endpoint should use HTTPS and authentication, avoid processing duplicate events, and return HTTP 200 quickly so Postmark does not retry unnecessarily.

Using the recipient address alone for matching is possible as a fallback, but storing the Espo Email ID in Postmark metadata will be much more reliable.

This can be packaged as a small EspoCRM extension with the endpoint, event entity, relationships and an event-history panel on the Email record. We can help with the implementation if you need development support.