Managed Links API
Create and manage hosted mobile attribution links with a workspace API key.
Last updated June 3, 2026
Use the Managed Links API to automate the same hosted links available in Settings. Send a workspace API key as a bearer token and identify the target app with its site ID from Settings > Tracking.
Replace YOUR_SITE_ID with your site ID from Settings > Tracking.
POST /api/mobile/deferred-links
1curl https://usegrometrics.com/api/mobile/deferred-links \2-H "Authorization: Bearer YOUR_API_KEY" \3-H "Content-Type: application/json" \4-d '{5"websiteId": "YOUR_SITE_ID",6"name": "TikTok bio",7"slug": "tiktok-bio",8"destinationPath": "/",9"fallbackUrl": "https://example.com",10"utmSource": "tiktok",11"utmMedium": "social",12"utmCampaign": "bio"13}'
Options / Configuration
| Option | Type | Required | Description |
|---|---|---|---|
| websiteId | string | ✓ | Target app site ID from Settings > Tracking |
| name | string | ✓ | Internal label shown in Grometrics |
| slug | string | ✓ | Unique lowercase public link ending |
| destinationPath | string | ✓ | In-app route beginning with one slash |
| fallbackUrl | URL | no | Web destination when the app cannot open |
| utmSource | string | no | Traffic source recorded for attribution |
| utmMedium | string | no | Marketing channel recorded for attribution |
| utmCampaign | string | no | Campaign recorded in attribution reports |
List managed links
1curl https://usegrometrics.com/api/mobile/deferred-links \2-H "Authorization: Bearer YOUR_API_KEY"
Disable a managed link
1curl -X PATCH https://usegrometrics.com/api/mobile/deferred-links \2-H "Authorization: Bearer YOUR_API_KEY" \3-H "Content-Type: application/json" \4-d '{ "id": "LINK_ID", "isActive": false }'
What happens next
List the workspace links after creation, then share the returned hosted URL without changing its generated query parameters.
Troubleshooting
Request is unauthorized
Check that the Authorization header uses a valid, unrevoked API key from the same workspace as the app site ID.
App is not found
Confirm websiteId is the mobile app site ID shown in Settings > Tracking, not a site ID from another workspace.
Was this page helpful?