Skip to main content
Question

409 Error When Granting Promotional Entitlement via API

  • July 29, 2025
  • 1 reply
  • 31 views

Forum|alt.badge.img

I'm encountering a 409 Conflict error when attempting to grant a promotional entitlement through the RevenueCat API. The request is failing consistently with the same error code.

API Endpoint: POST /v1/subscribers/{subscriber_id}/entitlements/{entitlement_id}/promotional

What specific condition is causing the 409?

This post has been closed for comments

1 reply

kaitlin
RevenueCat Staff
Forum|alt.badge.img+6
  • RevenueCat Staff
  • July 31, 2025

Hi ​@qa-team-kuncie-958e84!

We’re discussing this in a support ticket, but I want to post my answer here as well in case any future developers come upon this with the same issue. 

It looks like the 409 error was thrown with the additional message on our end of "There is another request in flight that is conflicting with this one."
 
In our server logs, I can see that in addition to the request to the promotional API endpoint for this user id, there was a POST request to update the user's subscriber attributes. Our system will throw an error like the 409 (you may also see 429, or 529) when two requests are trying to update the same resource - in this case, this user id. This is to prevent race conditions. 
 
If you see an error code relating to this, our recommendation is just to retry the request in a second or so. This should be enough time for the other request to finish. 

 

There’s also some additional information about these “Conflict” errors in this support article: