Company Connections

The Companies page at /fl/{nodeId}/companies is where you manage your working relationships with rental companies. Each connection represents a two-way link — you gain access to the company’s job opportunities, and they gain access to your profile, skills, and availability.

Connection status

A chip at the top of the page displays your current connection usage against your tier limit (e.g. 3/5 connections). When you approach the limit, a warning alert appears with a prompt to upgrade your subscription.

Connection limits by tier

• FREE — 5 company connections. New connection slots reset monthly.
• LITE (£9.99/month) — 20 company connections. New connection slots reset monthly.
• PRO (£19.99/month) — Unlimited company connections.

How connections work

Freelancer Node connections use an auto-connect model. When you visit a company’s join-crew page and create an account (or log in with an existing account), the connection is established instantly. No approval step from the company is required.

Each connection is stored as a NodeConnection record in your Node database with the following key fields:

• core_tenant_id — The UUID of the connected company’s tenant
• company_name — Cached company name for display
• company_subdomain — Cached subdomain for URL generation
• connection_type — One of standard, primary, or blocked
• status — One of active, inactive, pending, or blocked
• connected_at — Timestamp when the connection was established
• last_active_at — Updated each time there is activity with this company
• invited_by_user_id — UUID of the company user who sent the invitation, if applicable

Pending invitations

When a company sends you a direct invitation, it appears in the Pending Invitations section at the top of the page. Each invitation card shows:

• The company’s avatar (initials if no logo is available)
• Company name and the date the invitation was sent
• An optional personal message from the inviting company (invitation_message)
• Accept and Decline buttons

Accepting an invitation creates an active NodeConnection. If the invitation included a subscription discount (discount_percentage), that discount is applied permanently to your subscription — it persists even if you cancel and reactivate, or upgrade your tier.

Connected companies list

Your active connections are displayed as cards, each showing:

• Company logo or avatar — Generated from the company name initials if no logo exists
• Connection badge and date — Shows the connection_type (standard or primary) and the connected_at date
• Stats row — Total jobs completed (jobs_completed), total earned in GBP (total_amount_invoiced), and upcoming jobs count
• Actions menu — A dropdown with options to View details, View jobs, View invoices, and Disconnect

Company details popup

Clicking View details opens a dialog displaying the company’s contact information, your per-company statistics (jobs, hours, earnings, average rating), and a timeline of your working history with that company.

Connection types

Each connection has a type that determines its priority:

• Standard (standard) — The default connection type for all new connections
• Primary (primary) — Your main company. You can designate one connection as primary, which prioritises it in the sidebar and schedule views
• Blocked (blocked) — A connection that has been terminated. Blocked connections do not appear in your active list and the company can no longer see your profile

Disconnecting

To disconnect from a company, open the actions menu on the company card and select Disconnect. A confirmation dialog warns you that:

• You will lose access to that company’s job opportunities
• The company will no longer be able to book you
• Your historical records (completed jobs, earnings, time entries) are preserved in both databases
• You can reconnect in the future if a connection slot is available

Disconnecting sets the NodeConnection status to inactive. Corresponding records in the Core Tenant database are also updated via the dual-database sync.

Adding new connections

There are two ways to connect with a new company:

1. Visit a company’s join-crew page — Navigate to {subdomain}.nexusrms.io/join-crew and log in with your existing Freelancer Node credentials. The connection is created automatically.
2. Accept an invitation — If a company sends you a direct invitation, it appears in the Pending Invitations section. Click Accept to establish the connection.

Lifetime discounts

Companies can offer invitation discounts when inviting freelancers. These discounts are tracked in the FreelancerInvitationDiscount model with the following key fields:

• discount_percentage — Between 0% and 50% off your subscription price
• is_lifetime_discount — Always true. The discount never expires.
• original_monthly_price and discounted_monthly_price — Shows the before and after pricing

Only the first company to successfully invite you can apply a discount. The discount persists across plan upgrades (FREE to LITE to PRO), cancellations, and reactivations.

Sidebar blocks

• Connection status — Visual progress bar showing connections used versus tier limit
• Subscription tier comparison — Side-by-side comparison of FREE, LITE, and PRO features with upgrade buttons
• Quick stats — Aggregated totals across all companies: total jobs, total earned, and total days worked

Tips

• Connect to companies you want to work with — Each connection gives you access to that company’s job opportunities in your dashboard feed.
• Monitor your connection limit — If you are on the FREE or LITE tier, keep track of how many slots you have used. Disconnect from inactive companies to free up capacity.
• Set a primary company — If you work predominantly with one company, mark it as primary for quick access and priority display in your schedule.

Next steps

Continue to the next article to learn about managing your skills and certifications — the qualifications that determine which jobs you are eligible for.