Create a page link
Create a share link for the page's current version and return its url. By default the link follows every new publish; pass pinned=true to freeze it. Gates: optional password, access_mode EMAIL (asks for an email) or EMAIL_VERIFIED (sends a code; allowlists apply). submission_mode SINGLE closes the link after the first submission. 'context' freezes variable values into the texts of this link.
Authorization
bearerApiKey Create a scoped API key in the Adlass settings.
In: header
Path Parameters
Resource identifier: page_id.
uuidHeader Parameters
Optional correlation identifier.
length <= 128A unique key for this intended write. Reuse it only for an identical retry.
1 <= length <= 200Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/pages/123e4567-e89b-42d3-a456-426614174000/links" \ -H "Idempotency-Key: 123e4567-e89b-42d3-a456-426614174000" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "123e4567-e89b-42d3-a456-426614174000", "page_id": "123e4567-e89b-42d3-a456-426614174001", "page_version_id": "123e4567-e89b-42d3-a456-426614174002", "page_version_number": 3, "label": "Customer review", "status": "ACTIVE", "state": "active", "auth_version": 1, "expires_at": null, "max_visits": null, "visit_count": 4, "has_password": false, "access_mode": "ANONYMOUS", "allowed_emails": [], "allowed_domains": [], "submission_mode": "NONE", "submission_count": 0, "last_visited_at": "2026-09-04T12:00:00Z", "locale": null, "permissions": {}, "context": {}, "source_type": "USER", "source_id": null, "source_metadata": {}, "created_by": { "id": "123e4567-e89b-42d3-a456-426614174002", "name": "Ada Lovelace", "email": "ada@example.com" }, "created_at": "2026-09-04T12:00:00Z", "updated_at": "2026-09-04T12:00:00Z"}