#The Link object

Core resource that ties a shortlink or QR entrypoint to its workflow, destination, and analytics metadata, letting Linkbreakers serve dynamic experiences while tracking scans for a workspace.

createdAt

string (date-time)

When the link was created.

customDomain

object

Captures a branded hostname that Linkbreakers provisions for a workspace so scans and shortlinks resolve under the customer's domain, including verification and certificate lifecycle state.

customDomainId

string

The ID of the custom domain (UUID). This is the custom domain that is used to access the link. If not defined, the link will be accessed using the default domain.

directoryId

string

The ID of the directory this link belongs to (UUID). If not set, the link is at the root level (not in any directory).

entrypoint

string

The entrypoint URL This is the URL that is available to be redirected to the destination.

eventCount

string (int64)

The number of time the link has been scanned. This number isn't refreshed instantly but will update itself within a few seconds.

fallbackDestination

string

The fallback destination URL to use when workflow steps are broken

string

The unique identifier of the link (UUID)

leadGoalDefinition

string

Why this link exists, in the user's own words. Lead scoring reads this to choose the weighting for the link, so a link with neither goal nor target scores on neutral weights and gets no profile fit.

leadTargetDefinition

string

Who counts as a good lead for this link. Lead scoring matches visitor country and business signals against this text, and leaves profile fit unscored when it is empty.

metadata

object

A map of string key-value pairs. All values must be strings. Nested objects or arrays are not supported. Maximum of 50 keys.

name

string

The name of the link

pageTheme

object

Page theme configuration

pageThemeId

string

The ID of the page theme for this link (UUID).

qrcodeDesign

object

Captures the visual recipe Linkbreakers uses when rendering downloadable QR codes, including colors, shapes, export options, and center media. QR Code Designs are the visual representation of a link. They can be attached to QR Code Templates for reusability. They can only be attached to one record at a time.

qrcodeDesignId

string

The ID of the link design (UUID). This is the ID of the design that is used to generate the QR Code. If not defined, the design from the QR Code template will be used.

qrcodePendingUpdateSince

string (date-time)

When the link is pending QR Code update. This happens when the QR Code Design is updated and the QR Code image is still being processed.

qrcodeSignedUrl

string

The signed URL for the QR Code image. This URL eventually expires.

qrcodeTemplateId

string

The ID of the design template (UUID). This is the template that is used to generate the first QR Code Design assigned to the link. If not defined, a default QR Code Design will be generated.

shortlink

string

The short link for the link. This is the path segment that is attached to the URL. It can be defined by the client or generated by the system but is never null. It is unique within a custom domain or Linkbreakers default domain.

tags

array<object>

The tags associated with the link.

updatedAt

string (date-time)

When the link was last updated.

workspaceId

string

The workspace ID the link belongs to (UUID)

Learn more

Learn more about links in Linkbreakers

Example object

{
  "createdAt": "2026-08-05T00:40:01.636Z",
  "customDomain": {
    "activatedAt": "2026-08-05T00:40:01.636Z",
    "createdAt": "2026-08-05T00:40:01.636Z",
    "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "lastCheckedAt": "2026-08-05T00:40:01.636Z",
    "name": "example.com",
    "rootDestination": "https://example.com",
    "status": "STATUS_ACTIVE",
    "updatedAt": "2026-08-05T00:40:01.636Z",
    "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
  },
  "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
  "entrypoint": "https://linkbreak.ing/4BnH-R19p",
  "eventCount": 128,
  "fallbackDestination": "https://brand.example.com/fallback",
  "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
  "leadGoalDefinition": "string",
  "leadTargetDefinition": "string",
  "metadata": {},
  "name": "string",
  "pageTheme": {
    "badgeEnabled": false,
    "badgeIconColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "badgeId": "string",
    "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
    "bodyFont": {
      "bold": false,
      "color": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
      "fontSize": 0,
      "italic": false
    },
    "canvasColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "canvasCoverId": "string",
    "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
    "containerConfig": {
      "backgroundColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "borderColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "borderSize": 0,
      "borderStyle": "PAGE_THEME_BORDER_STYLE_UNSPECIFIED",
      "opacity": 0,
      "variant": "PAGE_THEME_CONTAINER_VARIANT_UNSPECIFIED"
    },
    "containerEnabled": false,
    "createdAt": "2026-08-05T00:40:01.636Z",
    "elementColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "elementFont": {
      "bold": false,
      "color": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
      "fontSize": 0,
      "italic": false
    },
    "id": "string",
    "titleFont": {
      "bold": false,
      "color": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
      "fontSize": 0,
      "italic": false
    },
    "updatedAt": "2026-08-05T00:40:01.636Z",
    "workspaceId": "string"
  },
  "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "qrcodeDesign": {
    "backgroundOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      }
    },
    "centralImageMargin": 0,
    "centralImageSignedUrl": "https://example.com",
    "centralImageSize": 0,
    "cornersDotOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
    },
    "cornersSquareOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
    },
    "createdAt": "2026-08-05T00:40:01.636Z",
    "dotsOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "DOTS_TYPE_UNSPECIFIED"
    },
    "errorCorrectionLevel": "string",
    "height": 0,
    "hideBackgroundDots": false,
    "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
    "shape": "SHAPE_SQUARE",
    "updatedAt": "2026-08-05T00:40:01.636Z",
    "width": 0
  },
  "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
  "qrcodePendingUpdateSince": "2026-08-05T00:40:01.636Z",
  "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
  "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
  "shortlink": "4BnH-R19p",
  "tags": [
    {
      "createdAt": "2026-08-05T00:40:01.636Z",
      "id": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
      "name": "string",
      "updatedAt": "2026-08-05T00:40:01.636Z"
    }
  ],
  "updatedAt": "2026-08-05T00:40:01.636Z",
  "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
}

GET/v1/linksRequires auth

#List links

Retrieves the shortened links for your workspace

#Parameters

query parameters

pageSize

integer (int64)Requiredquery

The maximum number of links to return.

pageToken

stringquery

The token for retrieving the next page of results If not provided, the first page of results will be returned

include

array<string>query

List of related resources to include in the response. Supported values: "customDomain", "qrcodeDesign", "qrcodeSignedUrl", "tags", "pageTheme". Use "qrcodeSignedUrl" to fetch signed QR image URLs—they are omitted by default to keep requests fast.

tags

array<string>query

Tags to filter links by (matches links containing any of the provided tags)

stringquery

Search query to filter links by name or shortlink Search query to filter links by name or shortlink

sortBy

stringquery

Field to sort links by (defaults to updated_at if not specified) Field to sort links by

Allowed values

LINK_SORT_FIELD_UNSPECIFIED

Sort field not specified (defaults to updated_at)

LINK_SORT_FIELD_CREATED_AT

Sort by creation date

LINK_SORT_FIELD_UPDATED_AT

Sort by last update date

LINK_SORT_FIELD_SHORTLINK

Sort by shortlink name

LINK_SORT_FIELD_NAME

Sort by link name

LINK_SORT_FIELD_EVENT_COUNT

Sort by event count

sortDirection

stringquery

Sort direction (defaults to descending if not specified) Sort direction (ascending or descending)

Allowed values

SORT_DIRECTION_UNSPECIFIED

Sort direction not specified (defaults to descending)

SORT_DIRECTION_ASC

Sort in ascending order

SORT_DIRECTION_DESC

Sort in descending order

view

stringquery

View mode. Default returns all links. LINK_VIEW_DIRECTORY scopes to a directory (or root when directory_id is empty). When directory_id is set, returns links in that directory. When directory_id is empty, returns root-level links (no directory).

Allowed values

LINK_VIEW_UNSPECIFIED

Return all links regardless of directory (default)

LINK_VIEW_DIRECTORY

Return links scoped to a directory.

directoryId

stringquery

Directory ID to scope to when view is LINK_VIEW_DIRECTORY. When empty with LINK_VIEW_DIRECTORY, returns root-level links.

#Response

200

Everything worked as expected.

links

array<object>

nextPageToken

string

Cursor to fetch the next page of links

totalCount

integer (int64)

Total number of links matching the current filters

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/links?pageSize={pageSize}&pageToken={pageToken}&include={include}&tags={tags}&search={search}&sortBy={sortBy}&sortDirection={sortDirection}&view={view}&directoryId={directoryId}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "links": [
    {
      "createdAt": "2026-08-05T00:40:01.607Z",
      "customDomain": {
        "activatedAt": "2026-08-05T00:40:01.607Z",
        "createdAt": "2026-08-05T00:40:01.607Z",
        "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
        "lastCheckedAt": "2026-08-05T00:40:01.607Z",
        "name": "example.com",
        "rootDestination": "https://example.com",
        "status": "STATUS_ACTIVE",
        "updatedAt": "2026-08-05T00:40:01.607Z",
        "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
      },
      "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
      "entrypoint": "https://linkbreak.ing/4BnH-R19p",
      "eventCount": 128,
      "fallbackDestination": "https://brand.example.com/fallback",
      "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
      "leadGoalDefinition": "string",
      "leadTargetDefinition": "string",
      "metadata": {},
      "name": "string",
      "pageTheme": {
        "badgeEnabled": false,
        "badgeIconColor": {},
        "badgeId": "string",
        "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
        "bodyFont": {},
        "canvasColor": {},
        "canvasCoverId": "string",
        "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
        "containerConfig": {},
        "containerEnabled": false,
        "createdAt": "2026-08-05T00:40:01.607Z",
        "elementColor": {},
        "elementFont": {},
        "id": "string",
        "titleFont": {},
        "updatedAt": "2026-08-05T00:40:01.610Z",
        "workspaceId": "string"
      },
      "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "qrcodeDesign": {
        "backgroundOptions": {},
        "centralImageMargin": 0,
        "centralImageSignedUrl": "https://example.com",
        "centralImageSize": 0,
        "cornersDotOptions": {},
        "cornersSquareOptions": {},
        "createdAt": "2026-08-05T00:40:01.610Z",
        "dotsOptions": {},
        "errorCorrectionLevel": "string",
        "height": 0,
        "hideBackgroundDots": false,
        "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
        "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
        "shape": "SHAPE_SQUARE",
        "updatedAt": "2026-08-05T00:40:01.610Z",
        "width": 0
      },
      "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "qrcodePendingUpdateSince": "2026-08-05T00:40:01.610Z",
      "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
      "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
      "shortlink": "4BnH-R19p",
      "tags": [
        {}
      ],
      "updatedAt": "2026-08-05T00:40:01.610Z",
      "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
    }
  ],
  "nextPageToken": "eyJsaW5rSWQiOiI0YmEifQ==",
  "totalCount": 42
}

Base URL: https://api.linkbreakers.com

GET/v1/links/{id}Requires auth

#Get link details

Retrieves information about a shortened link including its metadata and metrics.

#Parameters

path parameters

stringRequiredpath

The ID of the link to retrieve (UUID)

query parameters

include

array<string>query

#Response

200

Everything worked as expected.

link

object

Core resource that ties a shortlink or QR entrypoint to its workflow, destination, and analytics metadata, letting Linkbreakers serve dynamic experiences while tracking scans for a workspace.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/links/{id}?include={include}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "link": {
    "createdAt": "2026-08-05T00:40:01.620Z",
    "customDomain": {
      "activatedAt": "2026-08-05T00:40:01.620Z",
      "createdAt": "2026-08-05T00:40:01.620Z",
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "lastCheckedAt": "2026-08-05T00:40:01.620Z",
      "name": "example.com",
      "rootDestination": "https://example.com",
      "status": "STATUS_ACTIVE",
      "updatedAt": "2026-08-05T00:40:01.620Z",
      "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
    },
    "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
    "entrypoint": "https://linkbreak.ing/4BnH-R19p",
    "eventCount": 128,
    "fallbackDestination": "https://brand.example.com/fallback",
    "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
    "leadGoalDefinition": "string",
    "leadTargetDefinition": "string",
    "metadata": {},
    "name": "string",
    "pageTheme": {
      "badgeEnabled": false,
      "badgeIconColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "badgeId": "string",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
      "bodyFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "canvasColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "canvasCoverId": "string",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
      "containerConfig": {
        "backgroundColor": {},
        "borderColor": {},
        "borderSize": 0,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_UNSPECIFIED",
        "opacity": 0,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_UNSPECIFIED"
      },
      "containerEnabled": false,
      "createdAt": "2026-08-05T00:40:01.620Z",
      "elementColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "elementFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "id": "string",
      "titleFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "updatedAt": "2026-08-05T00:40:01.620Z",
      "workspaceId": "string"
    },
    "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "qrcodeDesign": {
      "backgroundOptions": {
        "themeColor": {}
      },
      "centralImageMargin": 0,
      "centralImageSignedUrl": "https://example.com",
      "centralImageSize": 0,
      "cornersDotOptions": {
        "themeColor": {},
        "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
      },
      "cornersSquareOptions": {
        "themeColor": {},
        "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
      },
      "createdAt": "2026-08-05T00:40:01.620Z",
      "dotsOptions": {
        "themeColor": {},
        "type": "DOTS_TYPE_UNSPECIFIED"
      },
      "errorCorrectionLevel": "string",
      "height": 0,
      "hideBackgroundDots": false,
      "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
      "shape": "SHAPE_SQUARE",
      "updatedAt": "2026-08-05T00:40:01.620Z",
      "width": 0
    },
    "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "qrcodePendingUpdateSince": "2026-08-05T00:40:01.620Z",
    "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
    "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "shortlink": "4BnH-R19p",
    "tags": [
      {
        "createdAt": "2026-08-05T00:40:01.620Z",
        "id": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
        "name": "string",
        "updatedAt": "2026-08-05T00:40:01.620Z"
      }
    ],
    "updatedAt": "2026-08-05T00:40:01.620Z",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}

Base URL: https://api.linkbreakers.com

GET/v1/links/{linkId}/lead-score/{eventId}Requires auth

#Get the stored lead score for an event

Returns the score exactly as it was recorded when the visitor came through, together with the factor breakdown and the weighting the link was scored on. Nothing is recalculated here.

#Parameters

path parameters

linkId

stringRequiredpath

The ID of the link (UUID)

eventId

stringRequiredpath

The ID of the event for which to generate the explanation (UUID)

#Response

200

Everything worked as expected.

breakdown

object

Breakdown of lead scoring factors

leadScore

integer (int32)

The lead score recorded for this event

recurringScans

integer (int32)

Number of recurring scans from this device+link combination

scoringContext

string

How this link was classified when its weighting was derived, for example "b2b_enterprise" or "community_social".

scoringRationale

string

Plain explanation of why the link is weighted the way it is. Empty when the link scores on the deterministic weighting.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/links/{linkId}/lead-score/{eventId}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "breakdown": {
    "brandSupportiveness": 0,
    "engagementLevel": 0,
    "profileFit": 0,
    "recurringInterest": 0,
    "technologicalAptitude": 0
  },
  "leadScore": 0,
  "recurringScans": 0,
  "scoringContext": "string",
  "scoringRationale": "string"
}

Base URL: https://api.linkbreakers.com

GET/v1/links/shortlink-availabilityRequires auth

#Check shortlink availability

Checks if a shortlink is available for use to create a new link. A custom domain can be provided to check against. It typically checks the shortlink slugs and shortlink IDs already present within the system.

#Parameters

query parameters

shortlink

stringquery

The shortlink to check availability for.

customDomainId

stringquery

The ID of the custom domain to check against (UUID) If not provided, checks against the default domain

#Response

200

Everything worked as expected.

available

boolean

Whether the slug is available for use

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/links/shortlink-availability?shortlink={shortlink}&customDomainId={customDomainId}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "available": false
}

Base URL: https://api.linkbreakers.com

GET/v1/links/shortlink-randomRequires auth

#Get a random shortlink

Generates a random availableshortlink for a new link.

#Parameters

This endpoint does not accept any parameters.

#Response

200

Everything worked as expected.

shortlink

string

Suggested available shortlink slug generated by the service

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/links/shortlink-random" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "shortlink": "string"
}

Base URL: https://api.linkbreakers.com

POST/v1/linksRequires auth

#Create a new link

This endpoint allows users to create a new shortened URL link in their Linkbreakers workspace. The URL will be checked for malicious content before being shortened.

#Parameters

This endpoint does not accept any parameters.

#Request body

conversionTracking

boolean

Enable conversion tracking by preserving lbid in redirect URL.

customDomainId

string

Optional custom domain ID (UUID). Leave empty to use the default domain.

destination

stringRequired

The destination URL to shorten. This field is required.

directoryId

string

The ID of the directory to create this link in (UUID)

fallbackDestination

string

The fallback destination URL to use when workflow steps are broken

string

Optional pre-generated link ID (UUID). Skipped from the AI tool schema: on a create there is no existing link to alias, so exposing it only invites the LLM to invent a raw UUID. The system generates the id and returns it as an alias in the response.

leadGoalDefinition

string

Why this link exists, in the user's own words. Lead scoring reads this to choose the weighting for the link, so a link with neither goal nor target scores on neutral weights and gets no profile fit.

leadTargetDefinition

string

Who counts as a good lead for this link. Lead scoring matches visitor country and business signals against this text, and leaves profile fit unscored when it is empty.

metadata

object

A map of string key-value pairs. All values must be strings. Nested objects or arrays are not supported. Maximum of 50 keys.

name

string

The name of the link

qrcodeDesignId

string

The QR Code design ID (UUID).

qrcodeTemplateId

string

The ID of the QR Code template (UUID)

shortlink

string

The shortlink (URL slug) for the link. If not given, a unique one is generated by the system.

tags

array<string>

List of tags to associate with the link. If a tag doesn't exist, it will be created.

waitForQrcode

boolean

Wait for QR code generation to complete before returning response.

#Response

200

Everything worked as expected.

link

object

Core resource that ties a shortlink or QR entrypoint to its workflow, destination, and analytics metadata, letting Linkbreakers serve dynamic experiences while tracking scans for a workspace.

workflowSteps

array<object>

The workflow steps that were created alongside the link. Every link is created with an entry step (event_action EVENT_ACTION_LINK_VISIT, kind KIND_ENTRY) and a default exit step, already connected to each other. They are returned here so a caller never has to guess or look up the entry step's id before attaching its own steps to it.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/links" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"conversionTracking":true,"customDomainId":"d290f1ee-6c54-4b01-90e6-d701748f0851","destination":"https://example.com","directoryId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","fallbackDestination":"https://example.com/fallback","id":"550e8400-e29b-41d4-a716-446655440000","leadGoalDefinition":"Increase newsletter signups","leadTargetDefinition":"Marketing qualified leads with budget > $10k","metadata":{},"name":"My Link","qrcodeDesignId":"a8c5e111-8894-4f8a-b5db-9efe0d12a210","qrcodeTemplateId":"0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d","shortlink":"my-link","tags":["string"],"waitForQrcode":true}'

Sample payload (application/json)

{
  "conversionTracking": true,
  "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "destination": "https://example.com",
  "directoryId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "fallbackDestination": "https://example.com/fallback",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "leadGoalDefinition": "Increase newsletter signups",
  "leadTargetDefinition": "Marketing qualified leads with budget > $10k",
  "metadata": {},
  "name": "My Link",
  "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
  "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
  "shortlink": "my-link",
  "tags": [
    "string"
  ],
  "waitForQrcode": true
}

Typical response

{
  "link": {
    "createdAt": "2026-08-05T00:40:01.612Z",
    "customDomain": {
      "activatedAt": "2026-08-05T00:40:01.612Z",
      "createdAt": "2026-08-05T00:40:01.612Z",
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "lastCheckedAt": "2026-08-05T00:40:01.612Z",
      "name": "example.com",
      "rootDestination": "https://example.com",
      "status": "STATUS_ACTIVE",
      "updatedAt": "2026-08-05T00:40:01.612Z",
      "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
    },
    "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
    "entrypoint": "https://linkbreak.ing/4BnH-R19p",
    "eventCount": 128,
    "fallbackDestination": "https://brand.example.com/fallback",
    "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
    "leadGoalDefinition": "string",
    "leadTargetDefinition": "string",
    "metadata": {},
    "name": "string",
    "pageTheme": {
      "badgeEnabled": false,
      "badgeIconColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "badgeId": "string",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
      "bodyFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "canvasColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "canvasCoverId": "string",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
      "containerConfig": {
        "backgroundColor": {},
        "borderColor": {},
        "borderSize": 0,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_UNSPECIFIED",
        "opacity": 0,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_UNSPECIFIED"
      },
      "containerEnabled": false,
      "createdAt": "2026-08-05T00:40:01.612Z",
      "elementColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "elementFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "id": "string",
      "titleFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "updatedAt": "2026-08-05T00:40:01.612Z",
      "workspaceId": "string"
    },
    "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "qrcodeDesign": {
      "backgroundOptions": {
        "themeColor": {}
      },
      "centralImageMargin": 0,
      "centralImageSignedUrl": "https://example.com",
      "centralImageSize": 0,
      "cornersDotOptions": {
        "themeColor": {},
        "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
      },
      "cornersSquareOptions": {
        "themeColor": {},
        "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
      },
      "createdAt": "2026-08-05T00:40:01.612Z",
      "dotsOptions": {
        "themeColor": {},
        "type": "DOTS_TYPE_UNSPECIFIED"
      },
      "errorCorrectionLevel": "string",
      "height": 0,
      "hideBackgroundDots": false,
      "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
      "shape": "SHAPE_SQUARE",
      "updatedAt": "2026-08-05T00:40:01.612Z",
      "width": 0
    },
    "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "qrcodePendingUpdateSince": "2026-08-05T00:40:01.612Z",
    "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
    "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "shortlink": "4BnH-R19p",
    "tags": [
      {
        "createdAt": "2026-08-05T00:40:01.612Z",
        "id": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
        "name": "string",
        "updatedAt": "2026-08-05T00:40:01.612Z"
      }
    ],
    "updatedAt": "2026-08-05T00:40:01.612Z",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  },
  "workflowSteps": [
    {
      "canvasPosition": {
        "x": 0,
        "y": 0
      },
      "childStepIds": [
        "string"
      ],
      "createdAt": "2026-08-05T00:40:01.612Z",
      "eventAction": "EVENT_ACTION_CLIENT_REDIRECT",
      "id": "a5f7b184-9d74-4f2a-9ed9-8f6a98cb12f4",
      "kind": "KIND_INTERACTION",
      "linkId": "123e4567-e89b-12d3-a456-426614174000",
      "nodeType": "NODE_TYPE_COMPOSITE",
      "parentStepIds": [
        "string"
      ],
      "payload": {
        "clientRedirect": {},
        "countryCondition": {},
        "dayOfMonthCondition": {},
        "dayOfWeekCondition": {},
        "deviceActorCondition": {},
        "deviceBrandCondition": {},
        "deviceBrowserCondition": {},
        "devicePlatformCondition": {},
        "deviceTypeCondition": {},
        "form": {},
        "linkVisit": {},
        "messagePage": {},
        "multiLink": {},
        "password": {},
        "socialLinks": {},
        "specificDateCondition": {},
        "thankYouPage": {},
        "timeOfDayCondition": {},
        "vcard": {},
        "visitTypeCondition": {},
        "visitorDataCondition": {}
      },
      "updatedAt": "2026-08-05T00:40:01.612Z"
    }
  ]
}

Base URL: https://api.linkbreakers.com

POST/v1/links/bulkRequires auth

#Create multiple links in a single request

Creates links in batch using the same per-link options as Create. This operation is transactional: if one link fails validation or insertion, no links from the batch are created.

#Parameters

This endpoint does not accept any parameters.

#Request body

links

array<object>Required

Links to create in one batch. Every item supports the same customization fields as CreateLinkRequest.

#Response

200

Everything worked as expected.

links

array<object>

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/links/bulk" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"links":[{"conversionTracking":true,"customDomainId":"d290f1ee-6c54-4b01-90e6-d701748f0851","destination":"https://example.com","directoryId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","fallbackDestination":"https://example.com/fallback","id":"550e8400-e29b-41d4-a716-446655440000","leadGoalDefinition":"Increase newsletter signups","leadTargetDefinition":"Marketing qualified leads with budget > $10k","metadata":{},"name":"My Link","qrcodeDesignId":"a8c5e111-8894-4f8a-b5db-9efe0d12a210","qrcodeTemplateId":"0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d","shortlink":"my-link","tags":["string"],"waitForQrcode":true}]}'

Sample payload (application/json)

{
  "links": [
    {
      "conversionTracking": true,
      "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "destination": "https://example.com",
      "directoryId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "fallbackDestination": "https://example.com/fallback",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "leadGoalDefinition": "Increase newsletter signups",
      "leadTargetDefinition": "Marketing qualified leads with budget > $10k",
      "metadata": {},
      "name": "My Link",
      "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
      "shortlink": "my-link",
      "tags": [
        "string"
      ],
      "waitForQrcode": true
    }
  ]
}

Typical response

{
  "links": [
    {
      "createdAt": "2026-08-05T00:40:01.615Z",
      "customDomain": {
        "activatedAt": "2026-08-05T00:40:01.615Z",
        "createdAt": "2026-08-05T00:40:01.615Z",
        "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
        "lastCheckedAt": "2026-08-05T00:40:01.615Z",
        "name": "example.com",
        "rootDestination": "https://example.com",
        "status": "STATUS_ACTIVE",
        "updatedAt": "2026-08-05T00:40:01.615Z",
        "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
      },
      "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
      "entrypoint": "https://linkbreak.ing/4BnH-R19p",
      "eventCount": 128,
      "fallbackDestination": "https://brand.example.com/fallback",
      "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
      "leadGoalDefinition": "string",
      "leadTargetDefinition": "string",
      "metadata": {},
      "name": "string",
      "pageTheme": {
        "badgeEnabled": false,
        "badgeIconColor": {},
        "badgeId": "string",
        "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
        "bodyFont": {},
        "canvasColor": {},
        "canvasCoverId": "string",
        "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
        "containerConfig": {},
        "containerEnabled": false,
        "createdAt": "2026-08-05T00:40:01.615Z",
        "elementColor": {},
        "elementFont": {},
        "id": "string",
        "titleFont": {},
        "updatedAt": "2026-08-05T00:40:01.615Z",
        "workspaceId": "string"
      },
      "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "qrcodeDesign": {
        "backgroundOptions": {},
        "centralImageMargin": 0,
        "centralImageSignedUrl": "https://example.com",
        "centralImageSize": 0,
        "cornersDotOptions": {},
        "cornersSquareOptions": {},
        "createdAt": "2026-08-05T00:40:01.615Z",
        "dotsOptions": {},
        "errorCorrectionLevel": "string",
        "height": 0,
        "hideBackgroundDots": false,
        "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
        "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
        "shape": "SHAPE_SQUARE",
        "updatedAt": "2026-08-05T00:40:01.615Z",
        "width": 0
      },
      "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "qrcodePendingUpdateSince": "2026-08-05T00:40:01.615Z",
      "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
      "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
      "shortlink": "4BnH-R19p",
      "tags": [
        {}
      ],
      "updatedAt": "2026-08-05T00:40:01.615Z",
      "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
    }
  ]
}

Base URL: https://api.linkbreakers.com

POST/v1/links/contactRequires auth

#Create a new contact card link

This endpoint allows users to create a new vCard contact link in their Linkbreakers workspace. The link will generate a vCard file for contact information sharing.

#Parameters

This endpoint does not accept any parameters.

#Request body

customDomainId

string

Optional custom domain ID (UUID). Leave empty to use the default domain. Only provide if the user explicitly asks for a specific custom domain.

fallbackDestination

string

Optional fallback URL if vCard download fails or is not supported.

leadGoalDefinition

string

Why this link exists, in the user's own words. Lead scoring reads this to choose the weighting for the link, so a link with neither goal nor target scores on neutral weights and gets no profile fit.

leadTargetDefinition

string

Who counts as a good lead for this link. Lead scoring matches visitor country and business signals against this text, and leaves profile fit unscored when it is empty.

metadata

object

A map of string key-value pairs. All values must be strings. Nested objects or arrays are not supported. Maximum of 50 keys.

name

string

The name of the link

qrcodeDesignId

string

The QR Code design ID (UUID). If you include this value, the specified design will be associated to this link only. A design can belong to one record at a time (Link or QR Code Template). Trying to use a design that's already assigned will cause an error.

qrcodeTemplateId

string

The ID of the QR Code template (UUID) If not given, the default QR Code template will be used to generate the QR Code design.

shortlink

string

The shortlink for the link If not given, the shortlink will be generated by the system.

tags

array<string>

List of tags to associate with the link. If a tag doesn't exist, it will be created.

vcardData

objectRequired

VCardData contains the contact information for vCard links

waitForQrcode

boolean

Wait for QR code generation to complete. Note: This makes the request slower compared to asynchronous generation.

#Response

200

Everything worked as expected.

link

object

Core resource that ties a shortlink or QR entrypoint to its workflow, destination, and analytics metadata, letting Linkbreakers serve dynamic experiences while tracking scans for a workspace.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/links/contact" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"customDomainId":"d290f1ee-6c54-4b01-90e6-d701748f0851","fallbackDestination":"https://company.com/contact","leadGoalDefinition":"Capture contact information for sales outreach","leadTargetDefinition":"Business contacts interested in our services","metadata":{},"name":"Jane Doe Contact Card","qrcodeDesignId":"a8c5e111-8894-4f8a-b5db-9efe0d12a210","qrcodeTemplateId":"0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d","shortlink":"jane-contact","tags":["string"],"vcardData":{"buttonLabel":"Add to contacts","city":"San Francisco","country":"United States","email":"[email protected]","firstName":"Jane","lastName":"Doe","organization":"Acme Corporation","phone":"+33123456789","phoneIsWhatsapp":false,"postalCode":"94102","socialLinks":[{"platform":"linkedin","url":"https://linkedin.com/in/janedoe"}],"state":"CA","streetAddress":"123 Main Street","title":"Software Engineer","website":"https://acme.com"},"waitForQrcode":true}'

Sample payload (application/json)

{
  "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "fallbackDestination": "https://company.com/contact",
  "leadGoalDefinition": "Capture contact information for sales outreach",
  "leadTargetDefinition": "Business contacts interested in our services",
  "metadata": {},
  "name": "Jane Doe Contact Card",
  "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
  "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
  "shortlink": "jane-contact",
  "tags": [
    "string"
  ],
  "vcardData": {
    "buttonLabel": "Add to contacts",
    "city": "San Francisco",
    "country": "United States",
    "email": "[email protected]",
    "firstName": "Jane",
    "lastName": "Doe",
    "organization": "Acme Corporation",
    "phone": "+33123456789",
    "phoneIsWhatsapp": false,
    "postalCode": "94102",
    "socialLinks": [
      {
        "platform": "linkedin",
        "url": "https://linkedin.com/in/janedoe"
      }
    ],
    "state": "CA",
    "streetAddress": "123 Main Street",
    "title": "Software Engineer",
    "website": "https://acme.com"
  },
  "waitForQrcode": true
}

Typical response

{
  "link": {
    "createdAt": "2026-08-05T00:40:01.616Z",
    "customDomain": {
      "activatedAt": "2026-08-05T00:40:01.616Z",
      "createdAt": "2026-08-05T00:40:01.616Z",
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "lastCheckedAt": "2026-08-05T00:40:01.616Z",
      "name": "example.com",
      "rootDestination": "https://example.com",
      "status": "STATUS_ACTIVE",
      "updatedAt": "2026-08-05T00:40:01.616Z",
      "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
    },
    "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
    "entrypoint": "https://linkbreak.ing/4BnH-R19p",
    "eventCount": 128,
    "fallbackDestination": "https://brand.example.com/fallback",
    "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
    "leadGoalDefinition": "string",
    "leadTargetDefinition": "string",
    "metadata": {},
    "name": "string",
    "pageTheme": {
      "badgeEnabled": false,
      "badgeIconColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "badgeId": "string",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
      "bodyFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "canvasColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "canvasCoverId": "string",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
      "containerConfig": {
        "backgroundColor": {},
        "borderColor": {},
        "borderSize": 0,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_UNSPECIFIED",
        "opacity": 0,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_UNSPECIFIED"
      },
      "containerEnabled": false,
      "createdAt": "2026-08-05T00:40:01.616Z",
      "elementColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "elementFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "id": "string",
      "titleFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "updatedAt": "2026-08-05T00:40:01.616Z",
      "workspaceId": "string"
    },
    "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "qrcodeDesign": {
      "backgroundOptions": {
        "themeColor": {}
      },
      "centralImageMargin": 0,
      "centralImageSignedUrl": "https://example.com",
      "centralImageSize": 0,
      "cornersDotOptions": {
        "themeColor": {},
        "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
      },
      "cornersSquareOptions": {
        "themeColor": {},
        "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
      },
      "createdAt": "2026-08-05T00:40:01.616Z",
      "dotsOptions": {
        "themeColor": {},
        "type": "DOTS_TYPE_UNSPECIFIED"
      },
      "errorCorrectionLevel": "string",
      "height": 0,
      "hideBackgroundDots": false,
      "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
      "shape": "SHAPE_SQUARE",
      "updatedAt": "2026-08-05T00:40:01.616Z",
      "width": 0
    },
    "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "qrcodePendingUpdateSince": "2026-08-05T00:40:01.616Z",
    "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
    "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "shortlink": "4BnH-R19p",
    "tags": [
      {
        "createdAt": "2026-08-05T00:40:01.616Z",
        "id": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
        "name": "string",
        "updatedAt": "2026-08-05T00:40:01.616Z"
      }
    ],
    "updatedAt": "2026-08-05T00:40:01.616Z",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}

Base URL: https://api.linkbreakers.com

POST/v1/links/thank-youRequires auth

#Create a new thank you page link

This endpoint allows users to create a new link with a thank you page as the exit step.

#Parameters

This endpoint does not accept any parameters.

#Request body

customDomainId

string

Optional custom domain ID (UUID). Leave empty to use the default domain. Only provide if the user explicitly asks for a specific custom domain.

description

string

Optional description displayed on the thank you page.

directoryId

string

Directory to organize this link into. If empty, link is created at root level.

leadGoalDefinition

string

Why this link exists, in the user's own words. Lead scoring reads this to choose the weighting for the link, so a link with neither goal nor target scores on neutral weights and gets no profile fit.

leadTargetDefinition

string

Who counts as a good lead for this link. Lead scoring matches visitor country and business signals against this text, and leaves profile fit unscored when it is empty.

metadata

object

A map of string key-value pairs. All values must be strings. Nested objects or arrays are not supported. Maximum of 50 keys.

name

string

The name of the link

qrcodeDesignId

string

qrcodeTemplateId

string

The ID of the QR Code template (UUID) If not given, the default QR Code template will be used to generate the QR Code design.

shortlink

string

The shortlink for the link If not given, the shortlink will be generated by the system.

tags

array<string>

List of tags to associate with the link. If a tag doesn't exist, it will be created.

title

stringRequired

Title displayed on the thank you page. This field is required.

waitForQrcode

boolean

Wait for QR code generation to complete. Note: This makes the request slower compared to asynchronous generation.

#Response

200

Everything worked as expected.

link

object

Core resource that ties a shortlink or QR entrypoint to its workflow, destination, and analytics metadata, letting Linkbreakers serve dynamic experiences while tracking scans for a workspace.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/links/thank-you" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"customDomainId":"d290f1ee-6c54-4b01-90e6-d701748f0851","description":"We appreciate your visit.","directoryId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","leadGoalDefinition":"Capture visitor appreciation and measure engagement","leadTargetDefinition":"Visitors who completed a purchase or signup","metadata":{},"name":"Thank You Page Link","qrcodeDesignId":"a8c5e111-8894-4f8a-b5db-9efe0d12a210","qrcodeTemplateId":"0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d","shortlink":"thank-you","tags":["string"],"title":"Thank you!","waitForQrcode":true}'

Sample payload (application/json)

{
  "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "description": "We appreciate your visit.",
  "directoryId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "leadGoalDefinition": "Capture visitor appreciation and measure engagement",
  "leadTargetDefinition": "Visitors who completed a purchase or signup",
  "metadata": {},
  "name": "Thank You Page Link",
  "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
  "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
  "shortlink": "thank-you",
  "tags": [
    "string"
  ],
  "title": "Thank you!",
  "waitForQrcode": true
}

Typical response

{
  "link": {
    "createdAt": "2026-08-05T00:40:01.618Z",
    "customDomain": {
      "activatedAt": "2026-08-05T00:40:01.618Z",
      "createdAt": "2026-08-05T00:40:01.618Z",
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "lastCheckedAt": "2026-08-05T00:40:01.618Z",
      "name": "example.com",
      "rootDestination": "https://example.com",
      "status": "STATUS_ACTIVE",
      "updatedAt": "2026-08-05T00:40:01.618Z",
      "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
    },
    "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
    "entrypoint": "https://linkbreak.ing/4BnH-R19p",
    "eventCount": 128,
    "fallbackDestination": "https://brand.example.com/fallback",
    "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
    "leadGoalDefinition": "string",
    "leadTargetDefinition": "string",
    "metadata": {},
    "name": "string",
    "pageTheme": {
      "badgeEnabled": false,
      "badgeIconColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "badgeId": "string",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
      "bodyFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "canvasColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "canvasCoverId": "string",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
      "containerConfig": {
        "backgroundColor": {},
        "borderColor": {},
        "borderSize": 0,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_UNSPECIFIED",
        "opacity": 0,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_UNSPECIFIED"
      },
      "containerEnabled": false,
      "createdAt": "2026-08-05T00:40:01.618Z",
      "elementColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "elementFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "id": "string",
      "titleFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "updatedAt": "2026-08-05T00:40:01.618Z",
      "workspaceId": "string"
    },
    "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "qrcodeDesign": {
      "backgroundOptions": {
        "themeColor": {}
      },
      "centralImageMargin": 0,
      "centralImageSignedUrl": "https://example.com",
      "centralImageSize": 0,
      "cornersDotOptions": {
        "themeColor": {},
        "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
      },
      "cornersSquareOptions": {
        "themeColor": {},
        "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
      },
      "createdAt": "2026-08-05T00:40:01.618Z",
      "dotsOptions": {
        "themeColor": {},
        "type": "DOTS_TYPE_UNSPECIFIED"
      },
      "errorCorrectionLevel": "string",
      "height": 0,
      "hideBackgroundDots": false,
      "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
      "shape": "SHAPE_SQUARE",
      "updatedAt": "2026-08-05T00:40:01.618Z",
      "width": 0
    },
    "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "qrcodePendingUpdateSince": "2026-08-05T00:40:01.618Z",
    "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
    "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "shortlink": "4BnH-R19p",
    "tags": [
      {
        "createdAt": "2026-08-05T00:40:01.618Z",
        "id": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
        "name": "string",
        "updatedAt": "2026-08-05T00:40:01.618Z"
      }
    ],
    "updatedAt": "2026-08-05T00:40:01.618Z",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}

Base URL: https://api.linkbreakers.com

PATCH/v1/links/{id}Requires auth

#Update a link

Updates an existing shortened link in your Linkbreakers workspace.

#Parameters

path parameters

stringRequiredpath

The ID of the link to update (UUID)

#Request body

directoryId

string

The ID of the directory to move this link into (UUID)

directoryIdDelete

boolean

Remove the link from its directory (move to root) If true, the directory_id will be set to null

fallbackDestination

string

The fallback destination URL to use when workflow steps are broken

leadGoalDefinition

string

Why this link exists, in the user's own words. Lead scoring reads this to choose the weighting for the link, so a link with neither goal nor target scores on neutral weights and gets no profile fit.

leadTargetDefinition

string

Who counts as a good lead for this link. Lead scoring matches visitor country and business signals against this text, and leaves profile fit unscored when it is empty.

name

string

The new name of the link

pageThemeId

string

Page theme ID to assign to this link

qrcodeTemplateId

string

QR code template ID to assign to this link

qrcodeTemplateIdDelete

boolean

Delete the QR code template ID from this link If true, the qrcode_template_id will be set to null

tags

array<string>

Set the tags to associate with the link. If a tag with the given name doesn't exist, it will be created.

tagsDelete

boolean

Delete all tags from the link If true, all tags will be removed from the link.

#Response

200

Everything worked as expected.

link

object

Core resource that ties a shortlink or QR entrypoint to its workflow, destination, and analytics metadata, letting Linkbreakers serve dynamic experiences while tracking scans for a workspace.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X PATCH "https://api.linkbreakers.com/v1/links/{id}" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"directoryId":"d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f","directoryIdDelete":false,"fallbackDestination":"https://example.com/fallback","leadGoalDefinition":"Increase newsletter signups","leadTargetDefinition":"Marketing qualified leads with budget > $10k","name":"My Updated Link","pageThemeId":"f47ac10b-58cc-4372-a567-0e02b2c3d479","qrcodeTemplateId":"0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d","qrcodeTemplateIdDelete":false,"tags":["string"],"tagsDelete":false}'

Sample payload (application/json)

{
  "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
  "directoryIdDelete": false,
  "fallbackDestination": "https://example.com/fallback",
  "leadGoalDefinition": "Increase newsletter signups",
  "leadTargetDefinition": "Marketing qualified leads with budget > $10k",
  "name": "My Updated Link",
  "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
  "qrcodeTemplateIdDelete": false,
  "tags": [
    "string"
  ],
  "tagsDelete": false
}

Typical response

{
  "link": {
    "createdAt": "2026-08-05T00:40:01.634Z",
    "customDomain": {
      "activatedAt": "2026-08-05T00:40:01.634Z",
      "createdAt": "2026-08-05T00:40:01.634Z",
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "lastCheckedAt": "2026-08-05T00:40:01.634Z",
      "name": "example.com",
      "rootDestination": "https://example.com",
      "status": "STATUS_ACTIVE",
      "updatedAt": "2026-08-05T00:40:01.634Z",
      "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
    },
    "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
    "entrypoint": "https://linkbreak.ing/4BnH-R19p",
    "eventCount": 128,
    "fallbackDestination": "https://brand.example.com/fallback",
    "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
    "leadGoalDefinition": "string",
    "leadTargetDefinition": "string",
    "metadata": {},
    "name": "string",
    "pageTheme": {
      "badgeEnabled": false,
      "badgeIconColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "badgeId": "string",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
      "bodyFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "canvasColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "canvasCoverId": "string",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
      "containerConfig": {
        "backgroundColor": {},
        "borderColor": {},
        "borderSize": 0,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_UNSPECIFIED",
        "opacity": 0,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_UNSPECIFIED"
      },
      "containerEnabled": false,
      "createdAt": "2026-08-05T00:40:01.635Z",
      "elementColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "elementFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "id": "string",
      "titleFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "fontSize": 0,
        "italic": false
      },
      "updatedAt": "2026-08-05T00:40:01.635Z",
      "workspaceId": "string"
    },
    "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "qrcodeDesign": {
      "backgroundOptions": {
        "themeColor": {}
      },
      "centralImageMargin": 0,
      "centralImageSignedUrl": "https://example.com",
      "centralImageSize": 0,
      "cornersDotOptions": {
        "themeColor": {},
        "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
      },
      "cornersSquareOptions": {
        "themeColor": {},
        "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
      },
      "createdAt": "2026-08-05T00:40:01.635Z",
      "dotsOptions": {
        "themeColor": {},
        "type": "DOTS_TYPE_UNSPECIFIED"
      },
      "errorCorrectionLevel": "string",
      "height": 0,
      "hideBackgroundDots": false,
      "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
      "shape": "SHAPE_SQUARE",
      "updatedAt": "2026-08-05T00:40:01.635Z",
      "width": 0
    },
    "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "qrcodePendingUpdateSince": "2026-08-05T00:40:01.635Z",
    "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
    "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "shortlink": "4BnH-R19p",
    "tags": [
      {
        "createdAt": "2026-08-05T00:40:01.635Z",
        "id": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
        "name": "string",
        "updatedAt": "2026-08-05T00:40:01.635Z"
      }
    ],
    "updatedAt": "2026-08-05T00:40:01.635Z",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}

Base URL: https://api.linkbreakers.com

DELETE/v1/links/{id}Requires auth

#Delete a link

Removes a shortened link from the workspace. This operation cannot be undone.

#Parameters

path parameters

stringRequiredpath

The ID of the link to delete (UUID)

#Response

200

Everything worked as expected.

No structured schema available for this section.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.