Shorten URL
yourls.create_short_url
ActionBusiness appsconnection required
Calls the YOURLS API with the connection's credentials.
Shorten a long URL, optionally on a keyword you choose.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- YOURLS
- Secret shape
- {"signature": "…"} or {"username": "…", "password": "…"}
- Config it needs
- base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
3 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
url The long URL to shorten. | string | Yes | — | url format | https://example.com/a-very-long-page |
keyword A custom keyword for the short link; leave blank to let YOURLS generate the next one. | string | No | — | — | launch |
title A title to store with the link; leave blank and YOURLS fetches the page's own title. | string | No | — | — | Launch announcement |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"keyword": "launch",
"title": "Launch announcement",
"url": "https://example.com/a-very-long-page"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
shorturl The full short link YOURLS created. | string | — |
keyword The keyword the short link uses. | string | — |
url The long URL that was shortened. | string | — |
title The title YOURLS stored with the link. | string | — |
date When YOURLS created the link. | string | — |
status YOURLS's own result word, 'success' on a new link. | string | — |
message YOURLS's own confirmation message. | string | — |
{
"date": "",
"keyword": "",
"message": "",
"shorturl": "",
"status": "",
"title": "",
"url": ""
}Notes
- On a YOURLS that refuses duplicates, shortening a URL it already holds answers 409 and fails the step; the error message is YOURLS's own and names the existing short URL.
- A keyword that is already taken or reserved is refused with 400.
Related YOURLS nodes
See Shorten URL run in a workflow.
In a technical demo we add the YOURLS connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.