---
title: "Generate deeplink"
method: POST
path: "/deeplink/generate"
tags: ["Deeplink"]
---

# Generate deeplink

`POST /deeplink/generate`

Convert a destination URL into a trackable affiliate link. Capped at 1,000 unique links per rolling 30-day window per account.

## Headers

- `Authorization` string, required

## Response `200`

Success

- ResponseEnvelope
  - `status` string, required — `success` or `error`.
  - `message` string — Human-readable status message.
  - `data` unknown, required

## Other responses

- `401` — Unauthorized. May indicate (a) bad/expired token — re-auth and retry once, OR (b) missing required params (validation errors are returned with status 401 today, not 422). Inspect the `message` field. Token errors may also break the standard envelope (e.g. `{message, status_code}` with no `status` key).
- `429` — Rate limit exceeded. Back off 250 → 500 → 1000 ms.
- `500` — Server-side error. On `/deeplink/generate`, a 500 is also returned for invalid `offer_id` or non-whitelisted destination URLs — these are PERMANENT client errors despite the 5xx code. Inspect `message`; retry only if you have reason to believe the request was previously valid.

---

[API](https://skmtc.net/involve/apis/involve-asia-publisher-api.md) · [All operations](https://skmtc.net/involve/apis/involve-asia-publisher-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/involve/involve-asia-publisher-api/revisions/56b6ef31077b/schema)