Docs Team Lead

Payabli

Oregon

Hybrid

USD 120,000 - 160,000

Full time

9 days ago

A complete application in a minute

Tailored resume and cover letter, ready to send.

Get past ATS filters

Benefits offered by this job

Competitive salary

Stock options

Flexible PTO and paid parental leave

Medical, dental, & vision insurance

401K, HSA

Job summary

Payabli is seeking a Docs Team Lead to guide a two-writer crew and own the API reference across Pay In, Pay Out, and Pay Ops. You’ll work alongside Product and Engineering, spending most time on technical writing tasks while also shaping team strategy and tooling.

You’ll drive documentation quality through OpenAPI, docs-as-code workflows, and AI-assisted processes, with a focus on reliability and clarity for developers using Payabli’s fintech APIs. This is a remote role reporting to the CTO.

Qualifications

8+ years in technical writing or developer documentation.
Experience leading technical writers.
Deep OpenAPI experience with docs-as-code workflows.
Read API responses, write scripts in TypeScript or Python.
Experience using AI coding agents in docs workflow.
Strong written communication, async-first.

Responsibilities

Lead the team of two writers, setting direction and mentoring.
Own the API reference for embedded payments APIs and ensure quality.
Own information architecture, docs CI/CD, style guide and linting rules.
Review PRs affecting docs and gate quality before SMEs.
Triage incoming engineering work and convert to docs tickets with priorities.
Publish monthly State of the Docs report using product analytics and search data.
Maintain and improve the public agent skills plugin and related tooling.

Skills

Technical leadership

Mentoring writers

Documentation strategy

Async communication

Quality focus

Tools

OpenAPI 3.1

Docs CI/CD

Git

Markdown/MDX

Job description

Payabli is the Intelligent Fintech Operating System for software platforms. If you are a software company, you are a fintech company, and Payabli is your operating system. Built by payments industry and SaaS veterans and powered by its own models, Payabli gives platforms everything they need to embed, manage, and monetize financial services through a single developer-friendly API spanning Pay In, Pay Out, and Pay Ops. Intelligence is not a layer on top, it is the foundation, expressed through Amigo™, Payabli's native AI Agent Suite, and a growing set of capabilities that make payment operations smarter and more autonomous.Payabli gives software companies PayFac capabilities without the heavy lift, administrative burden, or cost of becoming a payment facilitator themselves. With PayFac-as-a-Service, embedded payment acceptance and issuance, and intelligent payment operations, platforms turn payments into a meaningful revenue stream while staying focused on their core product.Payabli is backed by world-class fintech investors including QED Investors, Fika Ventures, TTV Capital, and Bling Capital, and was recently named to the Forbes Fintech 50.For more information, visit payabli.com.

About the role

Payabli's docs are how partners integrate with us. We want Payabli to be the easiest payments company to integrate with, and documentation is a big part of that. We're a small, high-ownership team situated alongside the Product and Engineering teams. We treat documentation as a product, and we write for humans and for the AI agents developers now build with.As Docs Team Lead, you'll set the direction for our developer and product docs. You'll lead a team of two technical writers and stay hands-on. You'll write, review, build tooling and own the API reference. This is a player-coach role. Expect to spend about three quarters of your time on your own technical work and a quarter leading the team.You'll report to CTO. This role is remote.

What you'll do

Lead the team

Manage and mentor two skilled technical writers. Hold 1:1s, develop careers, and keep ownership areas clear.
Trust people to own their work. Unblock them fast, and protect the team from burnout.
Run the team's rituals, including quarterly goal setting, backlog grooming, the PTO and coverage plan, and the culture work, such as writing workshops and blog posts.

Own the developer docs

Own the API reference for our embedded payments API across Pay In, Pay Out and Pay Ops. It's a multi-file OpenAPI 3.1 source.
Own information architecture, docs CI/CD, and our style guide and linting rules.
Use AI agents in your own daily workflow, with human review gates on everything they produce.
Help review PRs that touch the docs before they go to subject matter experts. You're the last human gate on quality.

Run docs operations

Triage incoming engineering and product work every day, and turn it into docs tickets with priorities and ship dates and delegate to the team.
Ship docs with every monthly production release, including the API changelog, release notes and the docs each feature needs to launch.
Hold the team to its published SLAs and release tiers, and keep stakeholders informed when something slips.

Own our agentic resources

Own our public agent skills plugin, which partners install in their coding agents. Keep it accurate as the API changes, using the evals that test it across several agents.
Own the skills, agent instructions, and agent tooling our Docs team depends on.

Measure and report

Publish a monthly State of the Docs report from product analytics, AI chat and search data.
Track team velocity, post-release docs work and AI answer coverage, and set targets for each.

What you bring

Must have

8+ years in technical writing or developer documentation, with real API reference experience
Experience leading or mentoring technical writers
Deep OpenAPI experience, plus docs-as-code workflows with Git, pull requests, CI and Markdown/MDX
Ability to read API responses, write scripts (TypeScript or Python) and build docOps tools
Hands‑on experience using AI coding agents in a docs workflow, and judgment about where they fail
A habit of verifying everything, and saying "I don't know yet" instead of guessing
Clear written communication, async‑first

Nice to have

Payments or fintech experience, such as card processing, ACH, payouts and merchant onboarding
Experience with Fern or a similar docs and SDK platform
A portfolio that shows API docs you wrote and docs tooling you built (We strongly prefer candidates with a portfolio site.)

How the docs team works

Users first. Our docs should help partners get in, get out and get back to what matters to them.
Safe hands. We want to be the most dependable team in the company. We don't guess, and we flag what we can't verify.
Written and async by default. Questions go in public channels. Feedback on work happens in PRs and tickets.
Ownership over approval. Writers own their areas. The lead sets direction and removes blockers.
Sustainable pace. Burnout is a signal that something needs to change, not a reason to push harder.

We think you'll love being part of our team becauseAt Payabli , you'll have a front row seat into building a high-growth venture backed fintech company. As a senior leader in Operations, you'll shape how the organization scales and be the driving force behind our AI-first operations strategy — directly influencing how we build, automate, and optimize for the future. You'll stretch yourself every day, learn a ton, grow alongside the company, and have a lot of fun building Payabli with us. We’re a values driven company that cares deeply about our team, partners, and customers. Our north star values are:Team Love = Customer Love — You understand that when you build great products for your internal partners, they deliver exceptional experiences to merchants. You obsess over the platform partners and businesses that depend on every payout landing on time.Run to the Fire — When ACH returns spike or a card program hits a snag, you're the first one in the war room. You don't shy away from hard problems—you chase them. You volunteer for the complex, messy challenges others avoid.Little Things Count — You sweat the details because you know a single decimal error in a payout can damage a business. You double-check edge cases, validate every assumption, and understand that excellence lives in the details.Truth Seekers — You give direct feedback, receive it with grace, and never let ego get in the way of finding the right answer. You document what you don't know, admit mistakes quickly, and hold yourself accountable in the open.Relentlessly Curious — You're constantly asking "what if?" and "why not?" You study how competitors solve problems, explore adjacent industries for inspiration, and never stop learning about the payments ecosystem.We build technology that gets noticed and a workplace where people want to grow their careers. Our work has been recognized by some of the industry's most respected organizations, including being named No. 43 on the 2026 Inc. 5000 , marking our third consecutive year on the list. Payabli was also named to the 2026 Forbes Fintech 50 , recognizing the most innovative private companies in financial technology, Inc.'s 2025 Best Workplaces , and Built In's 2026 Best Places to Work in Miami.

What we can offer you