Takeaways from our first hackathon
Tags: hackathon, fun, learning
Published: 2017-09-29 14:16:53

---
title: Takeaways from our first hackathon
published: true
description: A recap of Voucherify Hack Night
tags: hackathon, fun, learning
---

It’s been 4 weeks since Voucherify Hack Night took place. It’s high time to recap the competition and share our feelings about it. In this memo, we’d like to give a summary of what surprised us the most and why it might make sense to hold such an event for your product.

### Expectations

It was our first hackathon and in the beginning, we really didn’t know what to expect. Initially, we just wanted to see how our API is used by new developers in general. Building an API-first product requires paying utmost attention to great developer experience and smooth onboarding process, so we planned just to watch how devs interact with our:

* [Docs](https://docs.voucherify.io/?utm_campaign=tech&utm_medium=Link&utm_source=devto)
* [Examples](https://docs.voucherify.io/docs/examples?utm_campaign=tech&utm_medium=Link&utm_source=devto)
* [Help center](http://support.voucherify.io/?utm_campaign=tech&utm_medium=Link&utm_source=devto)
* [And, of course, the product itself](https://voucherify.io/?utm_campaign=tech&utm_medium=Link&utm_source=devto)

But there was also the second, sort of a business-oriented angle of the Hack Night. Voucherify as a standalone application doesn’t yield you as much value as when it’s a part of bigger marketing automation landscape. Voucherify shows its power when you [integrate](https://www.voucherify.io/integrations) it with other tools. Things we have created such as:

* [Dozen of SDKs](https://docs.voucherify.io/docs/sdks?utm_campaign=tech&utm_medium=Link&utm_source=devto)
* [Zapier integration](https://zapier.com/developer/invite/62387/cdcdf9275d825dff01c4da836b4c445f/)
* [Postman collection](https://app.getpostman.com/run-collection/9b17c94efccb5776be35#?env[test]=W3siZW5hYmxlZCI6dHJ1ZSwia2V5IjoidXJsIiwidmFsdWUiOiJodHRwczovL2FwaS52b3VjaGVyaWZ5LmlvL3YxIiwidHlwZSI6InRleHQifSx7ImVuYWJsZWQiOnRydWUsImtleSI6IlgtQXBwLUlkIiwidmFsdWUiOiJjNzBhNmYwMC1jZjkxLTQ3NTYtOWRmNS00NzYyODg1MDAwMmIiLCJ0eXBlIjoidGV4dCJ9LHsiZW5hYmxlZCI6dHJ1ZSwia2V5IjoiWC1BcHAtVG9rZW4iLCJ2YWx1ZSI6IjMyNjZiOWY4LWUyNDYtNGY3OS1iZGYwLTgzMzkyOWIxMzgwYyIsInR5cGUiOiJ0ZXh0In0seyJlbmFibGVkIjp0cnVlLCJrZXkiOiJDbGllbnQtQXBwLUlkIiwidmFsdWUiOiIwMTEyNDBiZi1kNWZjLTRlZjEtOWU4Mi0xMWViNjhjNDNiZjUiLCJ0eXBlIjoidGV4dCJ9LHsiZW5hYmxlZCI6dHJ1ZSwia2V5IjoiQ2xpZW50LUFwcC1Ub2tlbiIsInZhbHVlIjoiOWUyMjMwYzUtNzFmYi00NjBhLTkxYzYtZmJlZTY0NzA3YTIwIiwidHlwZSI6InRleHQifV0=)
* [and the REST API itself](https://docs.voucherify.io/reference)

have one goal — make integration with other ecommerce/SaaS tools as easy as 1–2–3. The more Voucherify-compatible plugins/connectors/apps exist, the more valuable our platform becomes. So we were super curious to learn what noteworthy integrations will show up on the table before they call it a night.

We got answers to these questions, but we got much more too! But let’s start off with the first two.

*WORK IN PROGRESS*
![](https://cdn-images-1.medium.com/max/800/0*Pc8dXiNEX9aL9wth.jpeg)

### Developer API onboarding

Having over 30 users from different domains interacting with your product in your office is an invaluable chance for a product team. Especially if the product is an API platform and the users are developers. We wanted to seize this opportunity and were looking over their shoulders all the time. We were particularly interested in:

* What SDK they used (what language is the most popular)
* How fast does it take to call the first request
* What tutorials and examples do they find useful/useless
* Is API reference up-to-date
* And so on

The overall reception was fine or excellent. In general, devs quickly figure out how to use our API. What’s worth highlighting is that they found our [Postman collection](https://app.getpostman.com/run-collection/9b17c94efccb5776be35#?env[test]=W3siZW5hYmxlZCI6dHJ1ZSwia2V5IjoidXJsIiwidmFsdWUiOiJodHRwczovL2FwaS52b3VjaGVyaWZ5LmlvL3YxIiwidHlwZSI6InRleHQifSx7ImVuYWJsZWQiOnRydWUsImtleSI6IlgtQXBwLUlkIiwidmFsdWUiOiJjNzBhNmYwMC1jZjkxLTQ3NTYtOWRmNS00NzYyODg1MDAwMmIiLCJ0eXBlIjoidGV4dCJ9LHsiZW5hYmxlZCI6dHJ1ZSwia2V5IjoiWC1BcHAtVG9rZW4iLCJ2YWx1ZSI6IjMyNjZiOWY4LWUyNDYtNGY3OS1iZGYwLTgzMzkyOWIxMzgwYyIsInR5cGUiOiJ0ZXh0In0seyJlbmFibGVkIjp0cnVlLCJrZXkiOiJDbGllbnQtQXBwLUlkIiwidmFsdWUiOiIwMTEyNDBiZi1kNWZjLTRlZjEtOWU4Mi0xMWViNjhjNDNiZjUiLCJ0eXBlIjoidGV4dCJ9LHsiZW5hYmxlZCI6dHJ1ZSwia2V5IjoiQ2xpZW50LUFwcC1Ub2tlbiIsInZhbHVlIjoiOWUyMjMwYzUtNzFmYi00NjBhLTkxYzYtZmJlZTY0NzA3YTIwIiwidHlwZSI6InRleHQifV0=) particularly useful. The interactive examples in [glitch](https://glitch.com/edit/#!/voucherify-cart) came helpful too.

But we also noticed some improvements. A couple of places in the spec were outdated and the SDKs didn’t cover all of the relevant endpoints of the API. Fortunately, our SDKs are [open source](https://docs.voucherify.io/docs/sdks) so devs were able to quickly point us into the right direction and we fixed the blind spots in the real time.

*Hack Night’s criteria*
![](https://cdn-images-1.medium.com/max/800/0*D8TgmfkGrfdWMyE6.jpg)


The pitch session was super exciting. The ideas, although limited in functionality, were super inspiring and thoughtful. The winning teams managed to convince the jury that they shipped something tangible and that chances are it’s gonna bring money. We had some positive feedback about quick integration with Voucherify, but we’d never have expected that you can build a working application under 12 hours! Here are some of the projects jury liked the most.

### Integrations

**1. Face2 — Distributing coupons via Facebook Marketing API**

*[@tarnas14](https://twitter.com/tarnas14) presenting their solution*
![](https://cdn-images-1.medium.com/max/800/0*uUth61zIgTM48hqT.jpeg)


The first team enabled launching coupon-based promo campaigns through Facebook’s ads. This allows marketers to link a dedicated, pre-generated promotion landing pages to a particular banner. These pages would show and assign a unique coupon code to every FB user then.

**2. Emotion-based groupon**

*Happiness detection*
![](https://cdn-images-1.medium.com/max/800/0*vEVOOysdssiHG34a.jpeg)


This mobile app recognizes user’s emotions through a camera and then adjusts coupon deals to a detected mood. Simple yet dangerously engaging.

**3. Exclusiv — Selling access to services via secret codes with Stripe payment gateway**

*Pitching — business model in details*
![](https://cdn-images-1.medium.com/max/800/0*E52bIY2qxIUmw3RP.jpeg)


The most down-to-earth but the most practical solution of the HackNight. This piece of code automates a lot of work for small retailers. With Exclusiv in place, after the payment is registered the access code is sent automatically with SMS or via email. No manual work needed at all.

### Added value

But the event brought us more than we expected:

* **Platform feedback** — apart from small improvements and fixes for docs and SDKs, we got some more thorough insights on how to improve our UI or what new endpoints to expose. And because we were right next to them, we could drill down these new concepts in no time.
* **Hiring** — watching developers code for 12 hours is an opportunity to come across a talent and to see for yourself he or she can deliver
* **Team bonding** — the whole team had much fun before, in the middle, and after the meetup (as we hit the floor in the club next-door). Organizing and executing hackathons is a good opportunity to get away from regular work and meet new, inspiring people.
* **Supporting partners** — it turns out that many developer tools companies are happy to support such events for free. We received nice SWAG packs and even annual subscriptions for their services from great products like
[Salesforce](http://developer.salesforce.com/),
[Contentful](https://www.contentful.com/),
[SendGrid](https://sendgrid.com/), [Brand24](http://brand24.com/),
[AWS](http://aws.amazon.com/), [Intercom](http://intercom.com/),
[twilio](http://twilio.com/).

*Winners in the spotlight*
![](https://cdn-images-1.medium.com/max/800/0*F_zBrr2xgyQPMC-X.jpeg)


### Lessons learned

We’ve drawn some conclusions about improvements too. For example, the way we framed the challenge itself was too complex and it made participants hesitant about signing up.

First of all, we called for only senior devs and it turns out they’re not so happy about hackathons anymore. Secondly, we wrapped the contest strictly around our domain — ecommerce tools. There are a lot of devs who don’t play with ecommerce SaaS and APIs on a daily basis so this was another deterrent decreasing attendance. Thirdly, we required participants to submit a form with the idea during sign-up process. We wanted to pre-screen them and choose only the best. In the end, we noticed the quality and content of these forms didn’t translate into the quality and content of final solutions. So the lesson for the next hackathon is to ditch them completely.

In general, we come to the conclusion that the next hackathon should be more fun-oriented from the very beginning.

*The ruthless judges*
![](https://cdn-images-1.medium.com/max/800/0*LlrMzP0AKOHeRKdm.jpeg)

So are we going to announce another call for hackers? Definitely, but this time we’ll also make sure it doesn’t have any artificial blockers, it’s easy to grasp the rules, and finally it’s all about fun in the first place!

![](https://cdn-images-1.medium.com/max/800/0*RpnUYSMUUuES8b7B.jpeg)

*****

*Originally published at
[www.voucherify.io](https://www.voucherify.io/blog/2017/9/29/takeaways-from-our-first-hackathon?utm_campaign=tech&utm_medium=Link&utm_source=devto)*