PARTNER NETWORK
DOCUMENTATION

HOW THE
PARTNER PORTAL
WORKS

A complete walkthrough for Build Partners — from provisioning to your first project.

01

HOW YOU GET PROVISIONED

You don't self-sign-up as a Build Partner. A 2NTH admin provisions your account after your application is reviewed and accepted.

STEP 1

Admin runs provisioning

The admin calls POST /api/admin/provision-partner with your email, display name, and company. This creates your account if it doesn't exist, or upgrades an existing one.

POST /api/admin/provision-partner
{
  "email": "you@company.com",
  "name": "Your Name",
  "company": "Your Company",
  "partnerCode": "BP-CUSTOM" // optional, auto-generated if omitted
}
STEP 2

Your account is set up

Four things happen atomically:

Plan

Elevated to Builder — the highest tier

Stage

CRM stage set to Contracted

Tokens

Token balance provisioned at 8,000,000

Code

Partner code BP-XXXXXX logged to CRM notes

STEP 3

Welcome email arrives

You receive an email from hello@2nth.ai with your partner code, a link to the platform, and instructions for your first sign-in.

02

FIRST SIGN-IN

Your first sign-in always uses a magic link sent to your email. No password required.

1

Visit 2nth.ai

Enter your email address

2

Check your inbox

Click the magic link

3

Signed in

Session cookie set on .2nth.ai

HOW IT WORKS

The magic link sets a secure 2nth_session JWT cookie on .2nth.ai. This cookie is shared across all 2NTH subdomains — so signing in once gives you access to the main platform, developers portal, skills hub, and agents.

03

SETTING UP FAST LOGIN

After your first email sign-in, you can set up a username and code so you never have to wait for an email link again.

STEP 1

Go to My Account

Navigate to 2nth.ai/account while signed in.

STEP 2

Scroll to Fast Login

Find the Fast Login section. Choose a username (3–24 chars, lowercase) and a passphrase or code (min 8 chars).

STEP 3

Save credentials

Credentials are PBKDF2-hashed (100K iterations, SHA-256) before storage. The plaintext code never touches the database.

STEP 4

Sign in at /quick-login

Use 2nth.ai/quick-login with your username + code. The endpoint returns a 302 with your session cookie.

USERNAME RULES
OK neil-andile
OK hyram2
NO -starts-with-hyphen
NO Uppercase or spaces
NO ab (under 3 chars)
SECURITY NOTE

The fast-login endpoint uses a constant 200ms delay on all responses (hit or miss) to prevent user enumeration via timing attacks. Usernames must be globally unique.

04

YOUR ACCOUNT & BALANCE

Everything you need is at 2nth.ai/account.

TOKEN BALANCE

As a Build Partner you start with 8,000,000 tokens. Your live balance is shown on the account page. Tokens are consumed when you interact with agents.

PROFILE

Set your display name, company, industry, and phone. These fields feed your public partner profile and give agents context about your business.

AI CONTEXT

The Enrich Your Profile section lets you describe your business, goals, and constraints. Agents read this before scoping any project you submit.

BILLING

View your transaction history, purchase additional token packs, and download invoices at /bill.

PLAN TIER

Your plan is shown as BUILDER. This gives you the highest agent context windows, full project access, and priority support.

QUICK ACTIONS

Submit a new project brief, run a design analysis through the seven lenses, or go straight to billing — all from the account dashboard.

05

YOUR PUBLIC PROFILE

Every Build Partner gets a public profile page that can be shared with clients and collaborators.

YOUR URL
developers.2nth.ai/partners/{your-display-name}

The slug is derived from your display name — lowercase, spaces become dashes. Set your display name at /account to activate your profile URL.

display_name = "Hyram"/partners/hyram
display_name = "Neil Andile"/partners/neil-andile
WHAT'S SHOWN
VERIFIED BUILD PARTNER
Display name Public
Company Public (if set)
Industry Public (if set)
Partner since (year) Public
Email / tokens / plan Never exposed
06

HOW PROJECTS WORK

You don't hunt for work. Projects come to you when agents identify that your domain is needed.

01

Client submits a brief

A client describes their project on the platform. The Brief Analyst agent decomposes it into design, software, hardware, and robotics scopes — identifying which pillars are needed and estimating token cost.

02

Agents do the groundwork

Before you're brought in, agents produce architecture specs, wireframes, hardware BOMs, or robotics requirements — whatever the scope demands. By the time you see the project, the scaffolding is done.

03

You receive a clear scope

You get: the agent's analysis, a list of deliverables, a timeline, and a budget — all derived from the brief. No vague asks, no spec-writing on your end.

04

You deliver

Submit your deliverables back into the platform. Agents handle integration, testing, and deployment steps where possible. Domain judgement stays with you.

05

Paid on completion

Contribution is costed in tokens, settled in ZAR on project completion. Transaction records are available in your billing dashboard.

07

TOKEN ECONOMICS

Tokens are the unit of work on the platform. They're used when agents process requests.

8M
BUILDER ALLOCATION

Starting balance for all Build Partners

ZAR
SETTLEMENT CURRENCY

Project earnings converted at current rate

100%
TRANSPARENT COSTING

Token cost quoted before project starts

+
TOP UP ANYTIME

Buy additional tokens via /bill

HOW TOKENS ARE CONSUMED

Each agent interaction deducts tokens based on input + output token count, with a platform markup applied. Demo interactions have a hard cap. Builder plan interactions use the full context window with no artificial limit.

READY TO START?

Sign in with your email to access the platform, then set up fast login from your account page.