OXYGENOxygen/ Docs
Workspace

Agency directory

Apply for, edit, publish, and pull your agency's listing in the public OXYGEN directory.

Get your agency onto oxygen-agent.com/agencies, then edit or unpublish that listing from the web app or the CLI.

The directory is invite-only. Until OXYGEN staff enable a listing for your organization, oxygen directory get returns directory_not_enabled and the settings screen shows an application form instead of the editor.

Apply

Two routes:

  • Web — open oxygen-agent.com/settings/directory, fill in Your agency website and Tell us about your agency, press Submit application.
  • CLI:
oxygen directory apply \
  --message "What we do, who we serve, and how we use OXYGEN for client work" \
  --website https://your-agency.com

Applying files a support request with the OXYGEN team. It costs 0 credits, creates no listing, and publishes nothing. One open application per organization — apply twice and you get back status: "already_applied".

If staff approve, they create the listing in invited status and seed its name and public slug. They may also prefill fields and set featured placement. That gives you an editor, not a live page; an update never publishes a draft.

Find the editor

/settings/directory is a deep link only. It has no sidebar entry and is not in the Settings popover in the sidebar footer. CLI and MCP responses hand you the URL as settings_url, and the public directory's Apply to be listed button points at it.

Once a listing exists, an Agency Directory tab also appears in the settings dialog: sidebar footer SettingsOrganisation settingsAgency Directory (/settings#/agency-directory). Organizations without a listing never see that tab.

Edit the profile

The editor autosaves: text fields save when you leave them, the Services and Regions served chips save shortly after you toggle them. Fields are Agency name, URL slug, Tagline, Logo (Upload image takes PNG, JPEG, WebP, or SVG up to 2 MB), Description, Founding team (Add founder), Website, Company LinkedIn, Book-a-call link, and Contact email.

The same edits from the CLI:

oxygen directory get --json
oxygen directory update --tagline "GTM systems for seed-stage B2B SaaS" --website https://your-agency.com

oxygen directory update --help prints every field flag plus the fixed Services and Regions values the form offers as chips. --profile-json sends a whole profile object under the API field names (website_url, booking_url, …); individual flags override it, and a null in that object is the only way to clear a field — an empty flag value is ignored.

On a published listing every save is public immediately — in the web editor that includes autosave. Unpublish first if you want to rework the copy.

Publish and unpublish

Publishing requires a tagline, a description, and at least one contact method (website, booking link, contact email, or company LinkedIn). Miss any of those and the call fails with directory_profile_incomplete, naming what to add.

  • WebPublish to directory. Once live, that button becomes Unpublish.
  • CLIoxygen directory publish and oxygen directory unpublish.

Neither spends credits, and neither writes to any platform outside OXYGEN. Both change a public web page, so run them only when you mean to. Unpublishing returns the listing to an editable draft; it does not delete it.

StatusBadge in the editorWhat it means
invitedDraft — not publicEditable, nothing public yet
publishedPublishedLive at oxygen-agent.com/agencies/<your-slug>
delistedRemoved by OXYGENPulled by staff, read-only — contact support

Once you are live

A published listing makes you an OXYGEN Certified Partner, or Featured Partner if staff pinned you. The editor then shows a Partner program panel with your badge in dark and light — Download SVG each, or Copy embed code for a badge that links back to your listing — and the affiliate rate: 30% on the first 12 months of every customer you refer. The Activate your affiliate link link appears only on deploys where the affiliate portal is configured.

On this page