RiftRift
Get API Key

Documentation

Manual Setup

This path is for teams who want to drive Rift with raw API calls and handle DNS manually. If you want the guided path, go back to the Quick Start.

1

Create your account

Sign up with your email to receive a verification link.

curl -X POST https://api.riftl.ink/v1/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'
2

Verify your email and save your secret key

Click the verification link in your inbox. Rift shows your secret key once in the browser. Save it immediately. It starts with rl_live_.

3

Set up your custom domain

Before you create a publishable key, you need a verified primary domain with a CNAME pointing to Rift.

Use the Custom Domains guide for the full DNS and verification steps.

4

Create a publishable key

Publishable keys are safe to use in the web and mobile SDKs for click tracking and attribution.

curl -X POST https://api.riftl.ink/v1/auth/publishable-keys \
  -H "Authorization: Bearer rl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "go.yourcompany.com"}'
5

Create your first link

curl -X POST https://api.riftl.ink/v1/links \
  -H "Authorization: Bearer rl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "web_url": "https://example.com",
    "ios_deep_link": "myapp://product/123",
    "agent_context": {
      "action": "purchase",
      "cta": "Buy now",
      "description": "Premium widget, 50% off today"
    }
  }'
6

Resolve and inspect the link

curl https://go.yourcompany.com/LINK_ID \
  -H "Accept: application/json"