Use the List79 API

The List79 API lets your own systems work with requests: forward requests from your support desk, show vote counts in your admin tools, or add votes for customers who ask on a call.

Create a secret key

Owners and admins create keys on the product's Keys page. A secret key starts with sk_ and is shown once, so copy it straight away and keep it on your server. Each key only works for its own product. If a key leaks, revoke it on the same page; calls with it then get 401.

Make a call

curl https://list79.com/api/v1/requests \
  -H "Authorization: Bearer sk_your_secret_key"

What you can do

• List requests and get one request
• Create a request (the author's vote is added automatically)
• Vote and remove a vote (a vote on a merged request goes to the request it was merged into)
• List and add comments
• Create or update a user, for example to record their monthly revenue

The full reference is the OpenAPI document, which you can load into tools such as Postman.

Users

Users are identified by your user IDs, and are created the first time you use them:

curl -X POST https://list79.com/api/v1/requests/1/votes \
  -H "Authorization: Bearer sk_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{ "user": { "id": "user_456", "email": "pat@example.com", "name": "Pat" } }'

IDs starting with email: or team: are reserved.

Format and limits

• JSON with camelCase names. Statuses are strings such as "underReview".
• Errors use the standard problem details format; validation errors list each field.
• Up to 300 calls a minute per product. After that you get 429 with a Retry-After header.