Request cURL
curl -s -X POST "https://app.upfour.io/v1/clients/00000000-0000-4000-8000-000000000001/share-links" \
-H "Authorization: Bearer $UP4_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"label": "Quarterly review"
}'
JavaScript
const res = await fetch("https://app.upfour.io/v1/clients/00000000-0000-4000-8000-000000000001/share-links", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.UP4_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
label: "Quarterly review",
}),
});
console.log(res.status, await res.json());
Python
import os
import requests
res = requests.post(
"https://app.upfour.io/v1/clients/00000000-0000-4000-8000-000000000001/share-links",
headers={"Authorization": f"Bearer {os.environ['UP4_API_KEY']}"},
json={
"label": "Quarterly review",
},
)
print(res.status_code, res.json())
Go
package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
payload := strings.NewReader(`{
"label": "Quarterly review"
}`)
req, _ := http.NewRequest("POST", "https://app.upfour.io/v1/clients/00000000-0000-4000-8000-000000000001/share-links", payload)
req.Header.Set("Authorization", "Bearer "+os.Getenv("UP4_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(out))
}
PHP
<?php
$payload = <<<'JSON'
{
"label": "Quarterly review"
}
JSON;
$ch = curl_init("https://app.upfour.io/v1/clients/00000000-0000-4000-8000-000000000001/share-links");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("UP4_API_KEY"),
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_RESPONSE_CODE), " ", $response, "\n";
curl_close($ch);
Response
201
{
"data": {
"client_id": "00000000-0000-4000-8000-000000000001",
"created_at": "2026-10-27T09:00:00Z",
"created_by": "00000000-0000-4000-8000-000000000002",
"expires_at": "2027-01-25T09:00:00Z",
"id": "00000000-0000-4000-8000-000000000003",
"label": "Quarterly review",
"token": "••••"
}
}
400
{
"error": {
"code": "bad_request",
"message": "The request is malformed or fails validation.",
"request_id": "req_…"
}
}
403
{
"error": {
"code": "permission_denied",
"message": "The credentials do not permit this action.",
"request_id": "req_…"
}
}
404
{
"error": {
"code": "not_found",
"message": "The requested resource does not exist or is outside the caller's scope.",
"request_id": "req_…"
}
}