Vote for a customer. Records a customer's vote on a post, for feedback heard on a call, email or ticket. Finds the customer by user_id, external_id or email and creates them if missing; blocked customers are refused. Optional priority (nice_to_have, important, must_have) and an internal note, both team-only. If they already voted, the vote stays: a priority or note you pass replaces theirs, and leaving them out (or priority none) keeps what they had; set_vote_priority lowers or clears them. Use find_similar_posts first so the vote lands on the right post. The customer isn't emailed, but follows the post from now on; the team may be notified at vote milestones.
Toolset
triage
Who can call it
OwnersManagersContributorsAPI keys
REST
POST /api/v1/w/{workspace}/posts/{post}/votes
Behavior
changes dataidempotentaccepts idempotency_key
Input
Field
Type
Description
postrequired
string
The post's ID (pst_…) or slug (the last part of its portal URL).
userrequired
object
The customer: user_id, external_id or email (created if missing, with name).
priority
one of: none, nice_to_have, important, must_have
How much the customer needs this: none, nice_to_have, important or must_have.
note
string
Internal note on the vote, such as a quote from the call. Team only.
idempotency_key
string
Retry-safe key. Repeating a call with the same key returns the first result.
Output
Field
Type
Description
postrequired
object
voterequired
object
createdrequired
boolean
True when a new vote was added.
changedrequired
boolean
False when the vote was already exactly as requested.
user_createdrequired
boolean
True when the customer was new and has been created.