Deep Links

Create tracked deep links for marketing campaigns, push notifications, and sharing. Every click is logged with analytics.

MCP tools

Example

Agent: "Create a tracked link for the summer promo email"

amba_tracked_links_create({
  project_id: "proj_xxx",
  slug: "summer-promo",
  destination_url: "myapp://promo/summer2025",
  metadata: {
    campaign: "summer_2025",
    source: "email",
    medium: "newsletter"
  }
})

This creates a tracked link with the slug summer-promo. Your app resolves the slug with Amba.deepLinks.get("summer-promo") (GET /v1/client/deep-links/resolve/summer-promo), which returns { id, url, short_code, target_path, metadata, created_at }: url is the destination and short_code the slug. The response also carries the same values as destination_url and slug. The app opens url and records the click with POST /v1/client/deep-links/click.

Clicks and deleted users

Each click records the link, the signed-in user, the platform the app sent, and the time. Clicks store no IP address, and earlier clicks have theirs cleared. Deleting a user keeps their clicks in the link's stats as anonymous clicks: the user is cleared on each one, and the link, platform, and time stay. Total and per-platform click counts stay the same, and unique users counts the users who still exist.

Client API reference