Reference · Account
POST/codes/redeem
Redeem a credit code
Redeem a credit code the person was given (for example SPRING-500): its credits go on their balance at once, to use within the code's days, spent before credits they buy. Each code works once for each account. Use it when the person gives you a code or asks to use one; it never charges anything. Returns the credits added, the day they must be used by and the new balance — or why the code gave nothing.
- Key needs
create· Make things and spend credits- Spends
- Nothing
- Answers
- Data
Request
curl -X POST https://vessero.com/api/v1/codes/redeem \ -H "Authorization: Bearer $VESSERO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "code": "WELCOME10" }'
Body
- codestringrequiredThe code as the person gave it; any case.
Answers
- 200okWhat it did, as data.
- 400invalid_requestA field is missing or not accepted: see details.
- 404not_foundNot found on this account.
- 403feature_unavailableThe studio this needs is switched off for the account right now.