shortening-linkslisted
Install: claude install-skill SendlyHQ/sendly-skills
# Branded URL Shortening with Sendly
Branded, owned-domain short links improve SMS deliverability — carriers filter public shorteners — and give you click analytics per link.
> **Not yet generally available.** URL shortening is gated behind the `url_shortener` rollout flag. Until it is enabled for your account, every API-key call returns `not_found` (404) — the feature reads as absent. Ask Sendly to enable it before relying on these endpoints.
## Quick start
```typescript
import Sendly from "@sendly/node";
const sendly = new Sendly(process.env.SENDLY_API_KEY!);
const link = await sendly.links.create({
url: "https://example.com/spring-sale?utm_source=sms",
});
console.log(link.shortUrl); // https://sendly.live/l/Ab3xY7
```
## REST API
**Base URL:** `https://sendly.live/api/v1`
### Create a short link
```bash
curl -X POST https://sendly.live/api/v1/links \
-H "Authorization: Bearer $SENDLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/welcome"}'
```
**Required:** `url` (http/https only)
**Response:**
```json
{
"code": "Ab3xY7",
"shortUrl": "https://sendly.live/l/Ab3xY7",
"destinationUrl": "https://example.com/welcome"
}
```
Uses your workspace's brand slug when one is configured (e.g. `https://sendly.live/l/acme/Ab3xY7`).
**Errors:** `invalid_url` (400, not an http/https URL), `workspace_required` (400, the key has no workspace), `not_found` (404, `url_shortener` flag off).
### List short links
```bash
curl "http