Grow with us: Join Postmark's new referral partner program and start earning
x

How to manually retry a failed inbound message

When you are receiving errors while trying your inbound webhook, you have the option of retrying them via the Message API.  

Postmark has a helpful endpoint in our API that you can use to resend those failed inbound messages. 

In order to make the API request, the MessageID is required. You can do that with the following example JSON and endpoint.  

Endpoint: https://api.postmarkapp.com/messages/inbound/{messageid}/retry

HTTP method: PUT 

Headers: 

  • Accept: application/json 
  • Content-Type: application/json 
  • X-Postmark-Server-Token: YourServerAPIToken

Here’s an example request with curl: 

	curl "https://api.postmarkapp.com/messages/inbound/{messageid}/retry" \
	  -X PUT \
	  -H "Accept: application/json" \
	  -H "X-Postmark-Server-Token: server token" \
	  -d ""

If you have multiple inbound webhooks failing, you can use this retry endpoint as many times as you’d like. Be sure to include the X-Postmark-Server-Token. This token can be found from the API Tokens tab under your Postmark server.

We recommend our easy-to-use API Explorer tool to retry a failed inbound message: 

  1. Go to API Explorer tool
  2. Messages API 
  3. PUT / messages / inbound / {messageid}/retry 

Your response will look like this: 

	HTTP/1.1 200 OK
	Content-Type: application/json

	{
	  ErrorCode: 0
	  Message: "Successfully rescheduled failed message: 041e3d29-737d-491e-9a13-a94d3rjkjka13."
	}

Check out our API Documentation for a complete list of our HTTP response codes.

Last updated March 29th, 2024

Still need some help?

Our customer success team has your back!