Adds a Destination to this Container and removes it from the Container to which it is currently linked.
HTTP request
POST https://tagmanager.googleapis.com/tagmanager/v2/{parent}/destinations:link
Path parameters
Parameters
parent
string
GTM parent Container's API relative path. It takes the form accounts/{account}/containers/{container}.
Query parameters
Parameters
destinationId
string
Destination ID to be linked to the current container.
allowUserPermissionFeatureUpdate
boolean
Must be set to true to allow features.user_permissions to change from false to true. If this operation causes an update but this bit is false, the operation will fail.
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of Destination.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-06 UTC."],[],[],null,["# Method: destinations.link\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\n**Full name**: accounts.containers.destinations.link\n\nAdds a Destination to this Container and removes it from the Container to which it is currently linked.\n\n### HTTP request\n\n`POST https://tagmanager.googleapis.com/tagmanager/v2/{parent}/destinations:link`\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` GTM parent Container's API relative path. It takes the form `accounts/{account}/containers/{container}`. |\n\n### Query parameters\n\n| Parameters ||\n|------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `destinationId` | `string` Destination ID to be linked to the current container. |\n| `allowUserPermissionFeatureUpdate` | `boolean` Must be set to true to allow features.user_permissions to change from false to true. If this operation causes an update but this bit is false, the operation will fail. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Destination](/tag-platform/tag-manager/api/reference/rest/v2/accounts.containers.destinations#Destination).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/tagmanager.edit.containers`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]