Install Jentic One Beta

Connect the Dub API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Dub API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fdub.co%2Fdub" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fdub.co%2Fdub" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Dub API.

Create short links with custom slugs and UTMs via POST /links

Read aggregated click, lead, and sale analytics via GET /analytics

Track lead and sale conversion events via POST /track/lead and POST /track/sale

Organise links with tags and folders via /tags and /folders

GET STARTED

Start building with Dub API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Dub API for, with concrete tasks.

★ Branded Short Links for Marketing Campaigns

Generate branded short links with UTMs for paid, social, and email campaigns. The agent calls POST /links with the destination, slug, and tags, then reads GET /analytics to roll up clicks by source. Branded short links reduce trust friction in social posts and let marketing teams retire links without breaking outbound creative.

POST /links with url='https://example.com/landing', domain='go.brand.com', and tags=['summer-2026'], then GET /analytics?linkId={id}&interval=7d for the click totals

Conversion Attribution for Referral Programs

Attribute leads and sales back to the referral link or partner that drove them. The agent fires POST /track/lead when a visitor signs up and POST /track/sale when they pay, passing the customer or external_id, so Dub joins the event chain back to the original click. This unlocks partner payouts and channel ROI reporting without building attribution from scratch.

On signup, POST /track/lead with clickId and external_id; on first paid invoice, POST /track/sale with the same external_id, amount, and currency

Partner Program Provisioning

Spin up partners for a referral program and issue them tracked links automatically. The agent calls POST /partners to add a partner record, then POST /links to mint a referral link tagged to that partner. Combined with the conversion tracking above, this drives a self-serve affiliate flow where each partner sees their attributed leads and sales.

POST /partners with the partner email and name, then POST /links with the destination URL and the partner's tenantId so referrals are attributed correctly

Agent-Driven Campaign Tooling via Jentic

Wire Dub into agent workflows that draft, publish, and measure campaigns. Through Jentic the agent searches by intent, loads the schema for /links or /analytics, and executes - the bearer token stays in your Jentic One instance, not the agent's prompt context.

Search Jentic for 'create a branded short link', load the Dub /links schema, and execute with a destination URL and tags supplied by the parent campaign agent

Key Endpoints

16 endpoints — jentic publishes the only available openapi specification for dub api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/links

Create a short link

GET

/links

List links

GET

/analytics

Retrieve click and conversion analytics

POST

/track/lead

Track a lead conversion event

POST

/track/sale

Track a sale conversion event

POST

/domains

POST

/partners

Create a referral partner

POST

/links

Create a short link

GET

/links

List links

GET

/analytics

Retrieve click and conversion analytics

POST

/track/lead

Track a lead conversion event

POST

/track/sale

Track a sale conversion event

POST

/domains

POST

/partners

Create a referral partner

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the Dub API by hand means handling its bearer auth and building the link, analytics, and conversion-tracking calls yourself. Through Jentic you install once, import Dub from the API Directory, store the token once, and your agent calls it.

Permission scoping

Dub identifies links and events through the request body and query, so you limit the agent to the operations it needs, such as creating a link or reading click analytics. You choose which operations are allowed, so tracking sales or creating domains is not included unless you add it.

Credential isolation

Your Dub bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'create a branded short link' or 'read click analytics', and Jentic returns the matching Dub operation with its input schema so the agent calls the right endpoint without browsing the docs.

FAQs

Specific to using Dub API through Jentic.

Why is there no official OpenAPI spec for Dub API?

Dub does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Dub API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

What authentication does the Dub API use?

Dub uses an OAuth-style bearer token in the Authorization header. Through Jentic the token is stored in the encrypted vault and injected at execution, so the raw bearer never enters the agent's prompt.

Can I create branded short links with the Dub API?

Yes. POST /links accepts the destination URL plus optional domain, slug, and tags, and returns a short link record. Register the branded domain first via POST /domains.

How do I track conversions with the Dub API?

Fire POST /track/lead when a click becomes a signup, then POST /track/sale on the first paid event with the same external_id. Dub joins those calls to the originating click for attribution.

What are the rate limits for the Dub API?

The OpenAPI spec does not declare rate limits. Dub publishes per-plan limits in its dashboard; have your agent retry HTTP 429 with exponential backoff.

How do I read campaign analytics through Jentic?

Search Jentic for 'retrieve link analytics', load the schema for GET /analytics, and execute with a linkId and interval (for example 7d). Install with pip install jentic.

Does the Dub API support a referral partner program?

Yes. POST /partners creates a partner record and POST /links can mint a referral link attributed to that partner, which combines with /track/lead and /track/sale for end-to-end attribution.

Can I limit what my agent is allowed to do with the Dub API?

Yes. Because Jentic One is self-hosted, your own rules decide which Dub operations and credentials the agent may use. You can allow only the endpoints a given workflow needs, such as POST /links to create a branded short link or GET /analytics to read click data, while leaving out operations like POST /track/sale or POST /domains unless you explicitly add them. Dub identifies links and events through the request body and query, so scoping happens at the operation level you control.

Dub API

Name: Dub API
Brand: Dub API
Availability: InStock

Agent-ready OpenAPI document · curated by JenticMarketingMarketing Automationbearer16 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Create branded short links, read click and conversion analytics, and manage marketing campaigns and partner programs through Dub.

Use for: I need to create a branded short link for a campaign, Get click analytics for a specific link in the last 7 days, Track a sale conversion against a referral link, List all links in a workspace

Not supported: Does not handle email sending, ad buying, or CRM contact records - use for short link management, click analytics, and conversion attribution only.

Jentic publishes the only available OpenAPI specification for Dub API, keeping it validated and agent-ready. Dub is link management infrastructure for marketing teams who need branded short links, conversion tracking, and partner programs. The API exposes 16 endpoints to create and manage short links, custom domains, tags, folders, analytics, events, partners, and workspaces. Authentication uses an OAuth-style bearer token, and the analytics surface returns aggregated click and conversion data sliced by attributes such as country, device, and referrer.

Jentic One on Github View OpenAPI Document

Connect the Dub API to your agent

Capabilities

Start building with Dub API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Dub API