2026-07-02 · Helen Marsh

Name the business event before you name the endpoint

When teams open an integration conversation with a list of URLs, they often wire the hop that is easiest to call instead of the hop that moves the business. In programming consulting for internal systems, we ask for the event first: goods received, membership renewed, invoice approved. Those names already live in operations language.

Once the event is named, endpoint choice becomes a secondary decision. You can still invent temporary stubs, but everyone knows what success looks like on Monday morning. A catalogue of REST resources without that anchor tends to produce polite adapters that never fire when the warehouse is busy.

Try a simple test in your next planning call. If nobody can finish the sentence “when X happens, system B must learn Y within Z minutes,” you are not ready to debate JSON field names yet. Write the sentence on a whiteboard, then invent the path.