DexURL

Add 1 to 50 links to a Bio page. On a published page the links go into its draft, which is not live until the owner presses Publish in the app; on an unpublished page they go straight onto the page. The connector never publishes a page. Addresses already on the page are skipped.

Create a short link. Free: a destination, title, click cap, expiry (up to 24 hours) and fallback address. Pro: slugPrefix (readable link text), oneTime, password, and the rules families below; the API says so when it refuses. destinationUrl is always required. With a choice page or board visitors see the options instead of being sent to it, with routing it is where visitors go when no rule matches and routing.defaultUrl is empty, and it is the link's main address in the library. A slugPrefix address always ends in 6 generated characters (spring-sale becomes spring-sale-k7m2q9). There are no tags: to compare channels (newsletter, Instagram, flyer) create one link per channel and name the channel in the title; find_links searches titles. Time: availability and routing time windows are read in their own timeZone (0 = Sunday); routing rules of type weekday and hour use UTC. qrUrl is the address the link's QR code contains (scanning it opens the link); it is not an image; open manageUrl to see or download the QR code. Examples: schedule: {"destinationUrl":"https://example.com/menu","rules":{"availability":{"timeZone":"Europe/Paris","weekdays":[1,2,3,4,5],"startMinutes":540,"endMinutes":1020}}} notice: {"destinationUrl":"https://example.com/partner","rules":{"redirectNotice":{"title":"Leaving DexURL","message":"You are going to our partner."}}} routing rules: {"destinationUrl":"https://example.com/web","rules":{"routing":{"defaultUrl":"https://example.com/web","rules":[{"type":"device","match":"ios","destinationUrl":"https://example.com/ios"}]}}} routing windows: {"destinationUrl":"https://example.com/day","rules":{"routing":{"windows":[{"timeZone":"UTC","weekdays":[0,1,2,3,4,5,6],"startMinutes":0,"endMinutes":720,"destinationUrl":"https://example.com/morning"}]}}} choice page: {"destinationUrl":"https://example.com/pick","rules":{"choiceOptions":[{"label":"Shop","destinationUrl":"https://example.com/shop"},{"label":"Blog","destinationUrl":"https://example.com/blog"}]}} multi-link board: {"destinationUrl":"https://example.com/links","rules":{"boardTitle":"Find us","destinations":[{"label":"Site","destinationUrl":"https://example.com"},{"label":"Docs","destinationUrl":"https://example.com/docs"}]}}

Delete a short link. It stops redirecting and leaves the library; printed QR codes for it stop working, and visitors may still be sent on for up to a minute. This cannot be undone from here. A link that is already deleted counts as not found. If a Bio page still lists the link, stillUsedOnBioPages names the page and whether the item is live or in the draft; the page itself is not changed.

List the signed-in user's short links, newest first, one page at a time. "query" searches slug, title and destination across the whole library: every word must match, case-insensitively. "status" keeps active or disabled links. clicks is the all-time click total, available on every plan. totalCount is every link in the account; matchCount (with query or status) is how many match. When nextCursor is present, pass it as "cursor" for the next page. Each link carries ruleLabels: password, one-time, expiry (has an expiry date), click-limit, fallback (a fallback address), schedule (weekly availability), routing (routing rules), time-windows (routing time windows), choice-page, board (multi-link board), notice (redirect notice page). get_link has the full rules. There is no file export: format results as a table or CSV text yourself.

Get the signed-in DexURL account: its email, plan (free or pro), the limits that plan carries, how much of each is used and what remains (null means no cap), which link features need Pro, and what this connector can and cannot do. Accounts under a day old also show their hourly link allowance.

List the Bio pages: handle, public address, whether it is published, title, editUrl for the app, and its links as items (live). When a page has an unpublished draft, hasUnpublishedDraft is true and draftItems lists what is waiting there; live items and draft items are separate, and a draft goes live only when the owner publishes it in the app.

Get one short link by its slug (the part of the short address after the last slash): destination, status, addresses, the all-time click total (clicks, available on every plan) and its rules in the same shape create_link and update_link accept, plus ruleLabels and manageUrl for the app. qrUrl is the address the link's QR code contains (scanning it opens the link); it is not an image; open manageUrl to see, style or download the QR code. expiresAt, maxClicks and fallbackUrl at the top level are read-only copies of the same fields inside rules. A password is never returned, only passwordProtected. A deleted link counts as not found.

Click statistics for all links or for one link with "slug". On the Free plan this returns all-time click totals per link; clicks by day, country, device and referrer need Pro. The window is the last N days ending today in UTC, not a calendar week or month; the result states from, to, days and timeZone. Totals, the busiest days and the top devices, countries and referrers (up to 10 each). For all links it also ranks topLinks and lists visitor choices (topChoices) and smart-route branches (topRoutes), each with its link slug.

Save a web address to the Vault with an optional title, folder, tags and note. Private items cannot be created here: send private: true and nothing is saved, with a pointer to the app. The Free plan holds 25 items.

List or search the saved links in the Vault, newest first. "query" is split into words; every word must match the title, address, a folder or a tag, ignoring case, and _ - / . count as spaces. Private items are never visible here. When nextCursor is present, pass it as "cursor" for the next page.

Change an existing short link: destination, title, status (active or disabled), password (Pro) or rules. Only the fields you send change. An edit changes where the existing short link and its printed QR codes go, and visitors may see the old behaviour for up to a minute. Each nested rules object (availability, redirectNotice, choiceOptions, destinations, routing.rules, routing.windows) is REPLACED as a whole, so call get_link first and send the complete object back with your change. Scalars are set one by one. To remove a rule send null: {"rules":{"maxClicks":null}} removes the click limit, {"rules":{"availability":null}} removes the schedule, {"rules":{"expiresAt":null}} the expiry. {"rules":{"passwordRequired":false}} removes password protection (the password is deleted). A title of "" or null clears the title. The result is the updated link as get_link shows it, plus changed: the fields this request sent.