API and webhooks: URLHop working inside your systems
Creating 300 QR codes by hand for the new catalog? Changing destinations one by one when your site moves? Let your systems do it. With an API key, they create links and QR codes, change destinations and read analytics. With webhooks, URLHop tells your tools when something happens.
When doing it by hand stops scaling
A store with hundreds of products, a real estate agency listing new homes every day, an agency managing dozens of clients. At some point, creating and updating links in the dashboard turns into repetitive work, and repetitive work leads to mistakes. The URLHop API does what the dashboard does, but from your own system, spreadsheet or automation tool. Webhooks go the other way: they tell you when something changes.
What you can do with the API
The URLHop API is a REST API that speaks JSON, with a public OpenAPI reference. Use it to create, edit and delete short links; change the destination of a QR code that's already printed; download QR codes; import up to 200 links at a time from a CSV; organize links into folders and tags; manage link-in-bio pages; and read each link's analytics. The dashboard's plan rules apply to the API too: for example, adding a password to a link requires Pro, and exporting raw analytics events as JSON requires Business.
Webhooks: URLHop tells you when something happens
Register an HTTPS address and choose your events. For each event, URLHop sends a POST with the data as JSON, signed with HMAC-SHA256 so you can confirm it came from us. If your system is down, delivery is retried for up to 9 hours, and the dashboard shows the delivery history. The events are: link created, updated or deleted (link.created, link.updated, link.deleted); click limit reached (link.click_limit_reached); link-in-bio page created, updated or deleted (tree.created, tree.updated, tree.deleted); domain verified (domain.verified); and 80% or 100% of the month's tracked clicks (usage.threshold_reached). It works with any tool that receives webhooks, such as n8n, Make or Zapier.
Real-world examples
How teams connect URLHop to the tools they already use.
Who uses it, and what happens
- An online store: when a new product is added, the store's system calls the API, creates the short link and QR code, and puts the code on the label. If the product page moves, the destination update is automatic too.
- A real estate agency: every new listing gets a link and a QR code for the yard sign. When the home sells, the system points the link to similar listings, and the sign keeps bringing in buyers.
- A marketing agency: every month, a script pulls each client's link clicks through the API and fills in the report spreadsheet, so nobody copies numbers by hand.
- A marketing team: the link.updated webhook runs through an n8n flow and posts a message in the team chat whenever someone changes where a printed QR code goes. Nobody gets caught off guard.
- A first-500-customers promo on a Pro plan: the link has a 500-click limit. When it's reached, the link.click_limit_reached webhook triggers a Make scenario that announces on social media that the coupon is gone.
- A finance team: the usage.threshold_reached webhook flags when the account hits 80% of the month's tracked clicks, in time to decide whether to change plans before counting pauses.
How to get started
You can make your first call in a few minutes.
Step by step
- In the dashboard, go to Settings → API and create a key. Give it a name that reminds you where it's used, like Store or CRM.
- Copy the key right away: it's shown only once, and URLHop keeps only its hash.
- Send the key in the Authorization: Bearer header on every request. Each key only reaches the workspace it was created in, is limited to 120 requests per minute and can be revoked at any time.
- For webhooks, go to Settings → Webhooks, paste your HTTPS address, choose the events and save the signing secret, which is also shown only once. Use the Send test button to check your integration.
- Browse the public API docs for every endpoint, with examples.
Which plan includes it
The API and webhooks are on the Starter plan and above, and in the 30-day free Pro trial every new account gets, no credit card. Some features follow the plan: password-protected links and CSV analytics export are Pro; raw analytics export as JSON through the API is Business. If your account goes back to Free, API keys stop working until you subscribe again, but no link is ever switched off.