Deciding Whether Your Product Needs an SDK
A working note on should you build an sdk — what matters, what does not, and where these projects usually go sideways.
should you build an sdk rarely arrives as a planned decision. It shows up mid-build, usually the week a deadline gets confirmed. These are the notes we end up repeating to founders and CTOs, written down once.
What breaks first
With should you build an sdk, the first failure is almost never technical. It is a mismatch between what the team thinks was agreed and what a customer expects.
Engineering then absorbs the gap, quietly, until a release slips.
Two situations that read identically on a Monday call
In projects like these, one version is local. A single workflow strains, everything else is fine, and two focused weeks clear it.
The other looks the same in a status update, but the strain is systemic. Treat that one as local and you spend a quarter arriving back where you started.
Telling them apart in week one is most of the value anyone brings to the room.
The mistakes that repeat
A mistake teams often make with should you build an sdk is starting from the most complex customer. Build for them and the simple case gets buried in configuration.
- Designing for a customer you have not signed yet.
- Copying a pattern from a company with fifty engineers.
- Deferring the boring part — permissions, exports, error states — until it blocks a deal.
- Measuring activity instead of outcome.
A real engineering perspective
The interesting work on should you build an sdk is not the happy path. It is the state you are left in when something stops halfway.
We write the failure cases first: duplicate input, partial write, stale cache, a customer clicking twice.
Then we make the successful path fall out of those constraints. It's slower on day one and much cheaper by month three.
How we approach it step by step
- Reproduce the pain with a real case, not a description of it.
- Write the target outcome as a single number.
- Pick the smallest change that could plausibly move that number.
- Build it with a rollback path.
- Release to one team or a slice of traffic.
- Review in two weeks, then widen, revise, or delete.
Deleting is a legitimate result. It happens less often than it should.
Practical guardrails
- Instrument before optimising.
- Cap spend and volume in code, not on the invoice.
- Write down the decision, not only the outcome.
- Keep one named owner with protected hours.
- Set a review date ninety days out and keep it.
Trade-offs worth saying out loud
Speed against flexibility. Managed service against control. Cheap now against cheap later. None of it is free.
This trade-off usually appears when the second customer wants something the first one didn't. That is the moment to revisit should you build an sdk, not before.
Where the common advice is wrong
“Do it the way the big companies do.” Their constraint is coordination across many teams. Yours is probably two engineers and a deadline.
“Automate everything.” Automate the repeated, boring, high-volume part. Leave judgement to people.
“Wait until we have more data.” Ship something small and the data arrives.
Frequently asked questions
How much should we budget?
Scope decides the number, but a focused first phase on work like this typically lands in the low five figures rather than a six-month programme.
What is the most common mistake with should you build an sdk?
Scoping too wide. Covering every case in version one delays feedback and raises cost without a matching benefit.
When is the right time to revisit the decision?
When a second customer asks for something the first one never needed, or when volume changes by an order of magnitude.
Is it cheaper to buy a tool instead?
Often yes for the first version. Build when the workflow is a genuine differentiator or no tool fits the data you already hold.
How do we know whether it worked?
Choose the number before you build — hours saved, error rate, response time, or conversion — then compare a two-week window either side.
Wrapping up
should you build an sdk does not need a perfect answer. It needs a written one, an owner, and a review date.
Pick the version you can run with the team you have today, then revisit it when the constraints change.
Related reading and next steps
- MVP development — how we run this kind of work.
- AI automations — where this often connects.
- More writing from the team.
Want a second opinion on should you build an sdk for your setup? Book a 30-minute call. If it is not worth building, we will say so.
FAQ
Frequently asked questions
How much should we budget?+
Scope decides the number, but a focused first phase on work like this typically lands in the low five figures rather than a six-month programme.
What is the most common mistake with should you build an sdk?+
Scoping too wide. Covering every case in version one delays feedback and raises cost without a matching benefit.
When is the right time to revisit the decision?+
When a second customer asks for something the first one never needed, or when volume changes by an order of magnitude.
Is it cheaper to buy a tool instead?+
Often yes for the first version. Build when the workflow is a genuine differentiator or no tool fits the data you already hold.
How do we know whether it worked?+
Choose the number before you build — hours saved, error rate, response time, or conversion — then compare a two-week window either side.
Building something similar?
Let's talk in 30 minutes.