# buildLink

suspend fun buildLink(request: [SharingRequest](/developers/references/android/id-frak-sdk-sharing/sharingrequest/)): [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)?

Builds a share link for request.

#### Return

null only when there is nothing to link to: the request carried no link, none of its products did, and neither the resolved config nor [id.frak.sdk.core.FrakMetadata.homepageLink](/developers/references/android/id-frak-sdk-core/frakmetadata/homepagelink/) supplies one. That is answerable without a network round trip, so it is an absence rather than a failure.

#### Throws

| | |
|---|---|
| [FrakError](/developers/references/android/id-frak-sdk-core/frakerror/) | when a link could have been built but could not be: tracking is disabled, the device refused key material, or no merchant could be resolved. |