Create Link
create_linkCreate a smart link in a ULink project for unified platform routing or dynamic deep links. Supports idempotent creation with externalId to avoid duplicates.
Instructions
Create a new smart link in a ULink project. Supports unified links (single URL that routes by platform) and dynamic links (parameterised deep links). You must specify the project, domain, and link type. Optionally set platform-specific URLs, fallback URLs, custom slug, metadata, and parameters. Pass externalId (any stable string from your system) to make creation idempotent on (project, externalId).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Human-readable name for the link | |
| slug | No | Custom slug for the short URL (auto-generated if omitted) | |
| type | Yes | Link type: 'unified' for smart routing or 'dynamic' for parameterised deep links | |
| iosUrl | No | URL to open on iOS devices | |
| domainId | Yes | The domain to host the link on | |
| metadata | No | Arbitrary metadata attached to the link | |
| projectId | Yes | The project to create the link in | |
| androidUrl | No | URL to open on Android devices | |
| externalId | No | Optional stable identifier from your system (e.g. 'share:user-123:post-456'). Repeated calls with the same (project, externalId) return the existing link instead of creating a duplicate. Idempotent. | |
| parameters | No | Key-value parameters passed through the deep link | |
| fallbackUrl | No | Fallback URL for unsupported platforms | |
| iosFallbackUrl | No | iOS-specific fallback URL (e.g. App Store link) | |
| androidFallbackUrl | No | Android-specific fallback URL (e.g. Play Store link) | |
| allowQueryPassthrough | No | When true, query params appended to this link URL at click time (e.g. ?orderId=123) are merged into the resolved link's parameters and OVERRIDE stored parameters with the same key. Parameter values arrive as strings. Applies on both immediate app open and after deferred install. No SDK change required. Default: false. |