# ProductCraft > Backend building blocks for apps and the AI agents that build and run them: Auth (sign-in, organizations, roles), Mail (transactional email on your domain), Waitlist, Social (feeds, follows, communities), Trawl (web pages to JSON), Flags (feature flags) and Notify (in-app, email and push notifications). Every product has a REST API with an OpenAPI document, a typed Node.js SDK, and tools on the ProductCraft MCP server. Every docs page below is Markdown: the links end in `.md`, and any docs URL also answers `Accept: text/markdown`. https://productcraft.co/llms-full.txt has every guide in one file. Rules files that teach a coding agent the SDKs (AGENTS.md, CLAUDE.md, Cursor): https://productcraft.co/docs/ai/rules?format=agents (add `products=auth,mail` to narrow it). ## Start here - [Build with AI](https://productcraft.co/docs/ai.md): Connect Claude Code, Cursor or Codex to ProductCraft: the MCP server, the docs as Markdown and llms.txt, rules files that teach an agent the SDKs, and scoped access a person approves. - [Documentation](https://productcraft.co/docs.md): API references, integration guides, and copy-paste examples for every ProductCraft service. - [MCP server](https://productcraft.co/docs/mcp.md): Connect Claude, Cursor or VS Code to a ProductCraft workspace over MCP. OAuth in the browser, no API key in a config file, every call in the audit log. - [SDKs | ProductCraft Docs](https://productcraft.co/docs/sdks.md): Official Node.js / TypeScript SDKs for the ProductCraft platform — Auth, Mail, Waitlist, Social, Trawl, Platform-Auth, and the productcraft umbrella package. Generated from the live OpenAPI specs, MIT-licensed, server-side. - [Testing | Docs](https://productcraft.co/docs/testing.md): How to test a ProductCraft integration without side effects: SDK mock fetch for unit tests, a separate test workspace for integration tests, and mailbox simulator addresses for Mail. - [Errors | Docs](https://productcraft.co/docs/api/errors.md): The error body every ProductCraft API returns: status_code, message, code and details. How to branch on code, what validation errors look like, and the deprecated statusCode alias. - [Error codes | Docs](https://productcraft.co/docs/errors.md): Every error code the ProductCraft APIs return: the HTTP status, what it means and what to do. Generated from the live OpenAPI specs. ## Platform - [Platform API Documentation](https://productcraft.co/docs/platform.md): Programmatic access to workspace setup, members, roles, service activation, and audit. For CI/CD, infrastructure-as-code, and admin automation that lives outside the console UI. - [Platform API — Getting started](https://productcraft.co/docs/platform/getting-started.md): Mint a workspace API key, hit your first endpoint, and automate workspace setup. Five-minute walkthrough. - [Guides | Platform Docs](https://productcraft.co/docs/platform/guides.md): Comprehensive guides for the Platform API: workspaces, members + roles, service activation, workspace API keys for CI/CD, audit + compliance. - [01 · Workspaces | Platform Guides](https://productcraft.co/docs/platform/guides/01-workspaces.md): The workspace primitive: boundary, lifecycle, multi-environment patterns. - [02 · Members + roles | Platform Guides](https://productcraft.co/docs/platform/guides/02-members-and-roles.md): Invite teammates, understand the system role defaults, author custom roles, navigate the sole-owner invariant. - [03 · Service activation | Platform Guides](https://productcraft.co/docs/platform/guides/03-service-activation.md): Enabling and disabling Auth, Mail, Waitlist, Social, Trawl per workspace. The SERVICE_NOT_ENABLED gate explained. - [04 · Workspace API keys for CI/CD | Platform Guides](https://productcraft.co/docs/platform/guides/04-pats-for-cicd.md): Mint a workspace API key, scope tightly, rotate, audit. The right way to give a deploy pipeline workspace access. - [05 · Audit + compliance | Platform Guides](https://productcraft.co/docs/platform/guides/05-audit-and-compliance.md): What the workspace audit log captures, querying patterns, exports for SOC2 / GDPR. - [Webhooks | Platform Docs](https://productcraft.co/docs/platform/webhooks.md): How every ProductCraft product sends webhooks: add an endpoint, verify Standard Webhooks signatures in Node, send a test, automatic retries, auto-disable, replay, secret rotation, and the older signature headers with their sunset dates. - [API Reference | Platform Docs](https://productcraft.co/docs/platform/api-reference.md): Platform API reference — workspaces, members, roles, service activation, workspace API keys, audit, introspection. Generated from the live OpenAPI spec served by platform-auth-api. ## Auth - [Auth Documentation](https://productcraft.co/docs/auth.md): Wire up multi-tenant auth end-to-end: apps, users, roles, tokens, JWKS. Getting started, core concepts, full API reference, and integration guides. - [Getting started | Auth Docs](https://productcraft.co/docs/auth/getting-started.md): Add sign-up and sign-in to your product in ten minutes: create an app, sign up a user, read their profile, and verify the token in your backend. Node SDK and curl. - [Tenant API keys | Auth Docs](https://productcraft.co/docs/auth/concepts/tenant-api-keys.md): API keys your customers create for their own automation against your app: how they differ from Platform API keys and app keys, the key format, expiry, the scope ceiling, rotate vs revoke, revocation latency, orphaned keys and the suspend switch. - [Core Concepts | Auth Docs](https://productcraft.co/docs/auth/concepts.md): Understand the building blocks of Auth: Apps, Users, Roles, Permissions, Tokens, and Audit Logs. - [Guides | Auth Docs](https://productcraft.co/docs/auth/guides.md): Comprehensive guides for integrating Auth: foundations, quickstart, roles + permissions, tenants, M2M, token verification, password and verification flows, webhooks + audit, Sign in with Apple, passkeys, migrating users from another provider, Sign in with Google and GitHub, tenant API keys for your customers. - [01 · Foundations | Auth Guides](https://productcraft.co/docs/auth/guides/01-foundations.md): The mental model: apps, identities, two API surfaces, per-app JWKS, when to reach for each lane. - [03 · Roles + permissions | Auth Guides](https://productcraft.co/docs/auth/guides/03-roles-and-permissions.md): Per-app RBAC: the system roles you start with, how to add custom roles, how to bind permissions, caller-narrowing, and the M2M-callable admin lane that lets your backend do all of it programmatically. - [04 · Multi-tenancy with tenants | Auth Guides](https://productcraft.co/docs/auth/guides/04-tenants.md): When and how to model your customers’ multi-tenancy as Auth tenants. The org_id JWT claim, tenant memberships, switching tenants, and the tenant-scoped role overlay. - [05 · M2M for backend services | Auth Guides](https://productcraft.co/docs/auth/guides/05-m2m-for-backend-services.md): OAuth 2.0 client_credentials grant for service-to-service auth. Scope narrowing, last_used_at, secret rotation, when M2M is right vs workspace API key. - [06 · Verify tokens | Auth Guides](https://productcraft.co/docs/auth/guides/06-verify-tokens.md): Three ways to verify a Auth token in your own service: local JWKS verification (fastest), /oauth/introspect (RFC 7662), and /verify + /authorize (one-call permission check). When to use each. - [07 · Verification + reset | Auth Guides](https://productcraft.co/docs/auth/guides/07-verification-and-reset.md): Email verification and password reset flows. The mint endpoints are API-key-only by design; you deliver the code via your own SMTP or via Mail, then consume on the public route. - [08 · Webhooks + audit | Auth Guides](https://productcraft.co/docs/auth/guides/08-webhooks-and-audit.md): The Auth webhook events and what they carry (signatures, retries and replay are in the shared Webhooks guide), then the per-app audit log for compliance + debugging. - [09 · Sign in with Apple | Auth Guides](https://productcraft.co/docs/auth/guides/09-signin-with-apple.md): Add Sign in with Apple to any Auth app. Native iOS / macOS, web redirect flow, account linking by verified email, audit + webhook events on every signin. - [10 · Passkeys | Auth Guides](https://productcraft.co/docs/auth/guides/10-passkeys.md): Add WebAuthn passkeys to an Auth app: the per-app relying-party config, passkeys as a second factor, passwordless sign-in, step-up — one SDK call per ceremony, or the raw HTTP and base64url encoding underneath. - [11 · Migrating users | Auth Guides](https://productcraft.co/docs/auth/guides/11-migrating-users.md): Bulk-import an existing user base as NDJSON with argon2id or bcrypt password hashes, read the per-row error report, watch credentials upgrade to argon2id on first signin, and export the directory back out. - [12 · Sign in with Google | Auth Guides](https://productcraft.co/docs/auth/guides/12-signin-with-google.md): Add Sign in with Google to an Auth app: create a Web application OAuth client in Google Cloud, paste the redirect URI the console shows, save the credentials (Auth checks them with Google), Try sign-in, then add the button to your site. - [13 · Sign in with GitHub | Auth Guides](https://productcraft.co/docs/auth/guides/13-signin-with-github.md): Add Sign in with GitHub to an Auth app: register a GitHub OAuth app with the callback URL the console shows, save the Client ID and secret (Auth checks them with GitHub), Try sign-in, then add the button to your site. - [14 · Let your customers create API keys | Auth Guides](https://productcraft.co/docs/auth/guides/14-tenant-api-keys.md): Adopt tenant API keys in your app: grant your Platform API key the two actions, push the key settings on boot, verify keys in your API with a cache, single-flight and a failed-verify budget, proxy key management through your backend, and accept keys only on the routes you mark. - [Agent access (OAuth for MCP) | Auth Docs](https://productcraft.co/docs/auth/agent-access.md): Let your users connect Claude Code or another AI agent to your app: one command, a browser consent on your own page, and tokens bound to your MCP server. Auth runs the OAuth 2.1 server; your app keeps the consent page and the permission check. - [API Reference | Auth Docs](https://productcraft.co/docs/auth/api-reference.md): Auth Consumer API: per-app EndUser signup, signin, sessions, and authorization. Generated from the live OpenAPI spec. ## Mail - [Mail Documentation](https://productcraft.co/docs/mail.md): Ship transactional email from your own domain: verify, template, sign, send. Full Mail guides, API reference, and copy-paste curl examples. - [Mail — Getting started](https://productcraft.co/docs/mail/getting-started.md): From zero to a signed, delivered transactional email: verify a domain, create a template, mint an API key, send. - [Guides | Mail Docs](https://productcraft.co/docs/mail/guides.md): Comprehensive guides for Mail: domain setup with DKIM/SPF, template authoring, sending, deliverability, bounce handling, and message operations. - [01 · Foundations | Mail Guides](https://productcraft.co/docs/mail/guides/01-foundations.md): The Mail mental model: workspace boundary, domains, mailboxes, templates, the suppression list. - [02 · Domain setup | Mail Guides](https://productcraft.co/docs/mail/guides/02-domain-setup.md): DKIM, MX, the verification flow. From `add domain` to `active` in fifteen minutes plus DNS propagation. - [03 · First send | Mail Guides](https://productcraft.co/docs/mail/guides/03-first-send.md): Author a template, preview it, send to a recipient. End to end in fifteen minutes. - [04 · Template authoring | Mail Guides](https://productcraft.co/docs/mail/guides/04-template-authoring.md): Handlebars syntax, variables, partials and layouts, the deliverability lint, and patterns that work in every major mail client. - [05 · Deliverability | Mail Guides](https://productcraft.co/docs/mail/guides/05-deliverability.md): Suppression list, bounce + complaint handling, webhook config, brand-reputation hygiene. - [06 · Operations | Mail Guides](https://productcraft.co/docs/mail/guides/06-operations.md): Message log, per-message detail, volume timeline, CSV export, RTBF deletion, and debugging delivery problems. - [07 · Contacts, topics, segments and broadcasts | Mail Guides](https://productcraft.co/docs/mail/guides/07-audiences.md): Contacts with consent, CSV import, topics, topic sends with one-click unsubscribe, the hosted preferences page, segments and broadcasts. - [API Reference | Mail Docs](https://productcraft.co/docs/mail/api-reference.md): Full Mail API reference. Domains, mailboxes, templates, suppression, messages — generated from the live OpenAPI spec. ## Waitlist - [Waitlist Documentation](https://productcraft.co/docs/waitlist.md): Waitlist management API. Custom fields, referral leaderboards, approval workflows, and a webhook stream — every endpoint generated from the live OpenAPI spec. Render the form on your own frontend; we handle the rest. - [Getting Started | Waitlist Docs](https://productcraft.co/docs/waitlist/getting-started.md): Spin up a waitlist in five minutes. Create it in the console, paste the ready-made sign-up snippet into your site, or POST entries to the public endpoint yourself. - [Guides | Waitlist Docs](https://productcraft.co/docs/waitlist/guides.md): Comprehensive guides for Waitlist: waitlist setup, public signup forms, approval workflow, variants, referrals, webhooks, analytics. - [01 · Foundations | Waitlist Guides](https://productcraft.co/docs/waitlist/guides/01-foundations.md): Waitlist primitives: waitlists, entries, custom fields, the public vs admin surface split. - [02 · Set up a waitlist | Waitlist Guides](https://productcraft.co/docs/waitlist/guides/02-waitlist-setup.md): Create the waitlist, activate it, configure workspace branding and notifications. - [03 · Public form | Waitlist Guides](https://productcraft.co/docs/waitlist/guides/03-public-form.md): The two anonymous endpoints your own signup form talks to. - [04 · Approval workflow | Waitlist Guides](https://productcraft.co/docs/waitlist/guides/04-approvals.md): Single + bulk status transitions, invite-to-Auth-app handoff, audit. - [05 · Variants + referrals | Waitlist Guides](https://productcraft.co/docs/waitlist/guides/05-variants-and-referrals.md): Serve locale- and A/B-specific copy from one waitlist, and credit referrers on signup. - [06 · Webhooks + analytics | Waitlist Guides](https://productcraft.co/docs/waitlist/guides/06-webhooks-and-analytics.md): The Waitlist webhook events (entry.created, entry.approved, entry.rejected) and what they carry, then analytics, the timeline and CSV export. Signatures, retries and replay are in the shared Webhooks guide. - [API Reference | Waitlist Docs](https://productcraft.co/docs/waitlist/api-reference.md): Full Waitlist API reference. Public signup endpoints, admin waitlist + entry management, webhooks, and analytics — generated from the live OpenAPI spec. ## Social - [Social Documentation](https://productcraft.co/docs/social.md): Drop a social layer into your product. Communities, follow graphs, posts, comments, ranked feeds, stories, polls, direct messages, notifications, and moderation — every endpoint generated from the live OpenAPI spec. - [Getting Started | Social Docs](https://productcraft.co/docs/social/getting-started.md): Add Social to a workspace, mint a workspace API key, project an end-user as an actor, create a community, and make your first call. - [Build a Social App | Social Docs](https://productcraft.co/docs/social/build-a-social-app.md): A ten-stage tutorial that walks every Social primitive end-to-end. By the time you reach the last page you have an Instagram/LinkedIn-shaped social product running on your own backend, talking to one HTTP API. - [Guides | Social Docs](https://productcraft.co/docs/social/guides.md): Guides for Social: the ten-stage Build a Social App tutorial (communities, actors, posts, engagement, social graph, feeds, stories, notifications, moderation, messaging) plus focused guides — reposts, quote posts, bookmarks, mentions, hashtags, search, drafts, edit history, notification preferences, actor lists, muted terms, and the community settings reference. - [01 · Set up | Build a Social App | Social Docs](https://productcraft.co/docs/social/build-a-social-app/01-setup.md): Spin up a community, mint a workspace API key, and make your first authenticated Social call. - [02 · Profiles | Build a Social App | Social Docs](https://productcraft.co/docs/social/build-a-social-app/02-profiles.md): Project your end-users into Social as actors. Upsert by external id, edit, list, and resolve. - [03 · Posts | Build a Social App | Social Docs](https://productcraft.co/docs/social/build-a-social-app/03-posts.md): Author text, link, and image posts on behalf of an actor. Update and soft-delete, save drafts, schedule for later, and record view counts in batch. - [04 · Engagement | Build a Social App | Social Docs](https://productcraft.co/docs/social/build-a-social-app/04-engagement.md): Threaded comments, multi-type reactions, and per-actor counters — the engagement loop. - [05 · Social graph | Build a Social App | Social Docs](https://productcraft.co/docs/social/build-a-social-app/05-graph.md): Follow, mute, block, restrict. Followers, following, mutes, blocks, and restricts lists. Block semantics that hold up, and Instagram-style restrict for quiet distance. - [06 · Home feed | Build a Social App | Social Docs](https://productcraft.co/docs/social/build-a-social-app/06-feed.md): The home feed (chronological or ranked), the discover feed for an explore tab, and list feeds — plus per-community ranking knobs and how muted terms and mutes filter what comes back. - [07 · Stories | Build a Social App | Social Docs](https://productcraft.co/docs/social/build-a-social-app/07-stories.md): Ephemeral posts with view tracking, close-friends visibility, polls, and pinned highlights. - [08 · Notifications | Build a Social App | Social Docs](https://productcraft.co/docs/social/build-a-social-app/08-notifications.md): Per-actor inbox produced automatically from follows, reactions, comments, mentions, votes, reposts, quotes, and DM activity. Twelve kinds, unread counts, mark-as-read, and the inbox/requests split. - [09 · Moderation | Build a Social App | Social Docs](https://productcraft.co/docs/social/build-a-social-app/09-moderation.md): End-users flag content from your backend; your team works the queue from the admin lane. Audit log included. - [10 · Messaging | Build a Social App | Social Docs](https://productcraft.co/docs/social/build-a-social-app/10-messaging.md): Direct and group conversations: open, send, edit, soft-delete, poll with `since` or the dm.message.created webhook, read markers + unread badges, DM reactions, the inbox/requests split, group admin ops, and the moderation lane. - [Actor Lists & List Feeds | Social Guides](https://productcraft.co/docs/social/guides/actor-lists.md): X-style lists: curate sets of actors, keep them private or publish them to the community, and read a dedicated chronological or ranked feed of posts by list members. - [Bookmarks | Social Guides](https://productcraft.co/docs/social/guides/bookmarks.md): Personal save-for-later list per actor in Social. Toggle bookmark on / off via POST / DELETE on the post; list per actor. - [Collections | Social Guides](https://productcraft.co/docs/social/guides/collections.md): Group posts into named collections — private bookmark folders and profile-public highlight reels — over one generic primitive. - [Comment reactions | Social Guides](https://productcraft.co/docs/social/guides/comment-reactions.md): Free-form emoji / type reactions on individual Social comments — same shape as post reactions. Idempotent toggle, denormalised reaction_counts on the comment, notification with target_kind='comment'. - [Community Settings Reference | Social Guides](https://productcraft.co/docs/social/guides/community-settings.md): Every supported community.settings key — ranked-feed weights, half-life and candidate window, max_comment_depth, auto_hide_flag_threshold, edit_window_minutes, max_group_conversation_size, max_pinned_comments — with defaults, bounds, and the feature each one drives. - [Fulfilling data-subject requests | Social Guides](https://productcraft.co/docs/social/guides/data-subject-requests.md): Assemble a complete GDPR Art. 15/20 export for one actor by walking the per-actor endpoints, and fulfil erasure with a single hard delete that cascades everything. - [Drafts | Social Guides](https://productcraft.co/docs/social/guides/drafts.md): Save unpublished posts in Social. status='draft' is hidden from every public read path; promote via PATCH { status: 'published' }. - [Edit history | Social Guides](https://productcraft.co/docs/social/guides/edit-history.md): X-style edit history for Social posts. Per-community 30-minute window (configurable), pre-edit snapshots in post_revision, edited_at + edit_count on the post row. - [Hashtag-followed feed | Social Guides](https://productcraft.co/docs/social/guides/hashtag-follows.md): Instagram-style 'follow a hashtag'. Posts using the followed tag appear in the actor's feed alongside posts from people they follow. - [Hashtags | Social Guides](https://productcraft.co/docs/social/guides/hashtags.md): Per-community #-tag indexing in Social. Parsed at write time inside the same transaction as the post insert; listing, detail, posts-for-tag, and prefix autocomplete endpoints. - [Hidden words & profanity filtering | Social Guides](https://productcraft.co/docs/social/guides/hidden-words.md): A community blocked-terms lexicon plus author-side muted-term holds. Matching comments are hidden or held for review, server-side. - [Creator insights | Social Guides](https://productcraft.co/docs/social/guides/insights.md): Per-post views + unique reach with a daily series, and a follower time series per actor — the data behind a creator-insights screen. - [Per-post interaction settings | Social Guides](https://productcraft.co/docs/social/guides/interaction-settings.md): Control who can comment, whether reaction counts are shown, and whether a post can be reposted or quoted — enforced server-side via the typed post.settings object. - [Media uploads & attachments | Social Guides](https://productcraft.co/docs/social/guides/media-assets.md): Upload images and videos once — EXIF-stripped renditions, transcoded MP4s and posters behind short-lived presigned URLs — and attach them to posts, comments, and DMs by id. - [Mentions | Social Guides](https://productcraft.co/docs/social/guides/mentions.md): @-mention parsing, indexing, notifications, and the per-actor mentions feed in Social. Lowercased, deduped, capped at 50 per body. Unknown handles silently ignored. - [Moderation queue & enforcement | Social Guides](https://productcraft.co/docs/social/guides/moderation.md): File flags against posts, comments, actors, or DMs; work the flag queue or act directly on unflagged content; suspend/reinstate actors and moderator-soft-delete direct messages; let reporters poll their own report status. - [Muted Terms | Social Guides](https://productcraft.co/docs/social/guides/muted-terms.md): Per-actor keyword muting. Case-insensitive substring matching over post bodies and titles, scoped to feed / dm / mention / all, with optional expiry — the "mute this spoiler for a week" primitive. - [Not interested & don’t suggest | Social Guides](https://productcraft.co/docs/social/guides/negative-feedback.md): Two negative-feedback primitives: hide a post ("not interested") as a hard feed filter, and dismiss an actor from your follow suggestions. - [Notification preferences | Social Guides](https://productcraft.co/docs/social/guides/notification-preferences.md): Per-actor / per-kind notification opt-out for Social. Mute follow notifications, keep mentions on — your call. Default is everything-on; absence of a row equals enabled. - [Private accounts & follow requests | Social Guides](https://productcraft.co/docs/social/guides/private-accounts.md): Make an actor private: their posts cap at followers-only, and following requires an approved request. Approve, decline, and list incoming requests server-side. - [Quote posts | Social Guides](https://productcraft.co/docs/social/guides/quote-posts.md): X-style quote-tweet for Social. Quote posts are regular posts with kind='quote' + source_post_id + a body of your own. Reuse the post-create endpoint. - [Reposts | Social Guides](https://productcraft.co/docs/social/guides/reposts.md): X-style retweet for Social. Reposts ride on the existing post pipeline (kind='repost' + source_post_id) so feeds, reactions, comments all work without bespoke code. - [Post search | Social Guides](https://productcraft.co/docs/social/guides/search-posts.md): Postgres FTS-backed post content search in Social. Generated tsvector over title + body, ranked by ts_rank or ordered by recency. - [User search | Social Guides](https://productcraft.co/docs/social/guides/search-users.md): Postgres FTS-backed actor search in Social. Generated tsvector over display_name + external_id + bio, GIN-indexed, ranked by ts_rank. - [Suggested follows | Social Guides](https://productcraft.co/docs/social/guides/suggested-follows.md): Friend-of-a-friend follow recommendation in Social. Surfaces actors the requester's followees also follow, with a top-by-followers cold-start fallback for new accounts, and a dismiss action that takes effect immediately. - [Tagging people in posts | Social Guides](https://productcraft.co/docs/social/guides/tagging.md): Tag actors in a post with review: tags land pending, the tagged actor approves or removes them, and approved tags surface on their /tagged profile listing. - [Webhooks | Social Guides](https://productcraft.co/docs/social/guides/webhooks.md): The Social webhook events, one endpoint for a whole workspace or one per community, and what each event carries. Signatures, retries and replay are in the shared Webhooks guide. - [API Reference | Social Docs](https://productcraft.co/docs/social/api-reference.md): Full Social API reference. Communities, actors, posts, edges, comments, feeds (chronological + ranked + discover), conversations/DMs, notifications, the complete stories surface, and the workspace admin lane — generated from the live OpenAPI spec. - [Admin API Reference | Social Docs](https://productcraft.co/docs/social/api-reference/admin.md): The Social workspace admin lane: community CRUD, community settings, the moderation queue, flag actions and audit log, conversation moderation and analytics, generated from the live OpenAPI spec. ## Trawl - [Trawl Documentation](https://productcraft.co/docs/trawl.md): Turn any public web page into structured JSON. Submit a JSON Schema and a description; an AI agent browses the web and returns schema-validated data. Getting started, core concepts, full API reference, and integration guides. - [Getting started | Trawl Docs](https://productcraft.co/docs/trawl/getting-started.md): Zero to your first successful extraction. Create a job, poll until it succeeds, read the structured result. - [Core Concepts | Trawl Docs](https://productcraft.co/docs/trawl/concepts.md): Understand the building blocks of Trawl: jobs, the job lifecycle, the extraction agent, webhooks vs polling, and the workspace permission model. - [Guides | Trawl Docs](https://productcraft.co/docs/trawl/guides.md): Comprehensive guides for Trawl: the job model, your first extraction, JSON Schema design, webhook delivery, and production operations. - [01 · Foundations | Trawl Guides](https://productcraft.co/docs/trawl/guides/01-foundations.md): Workspace boundary, enabling the trawl service, minting a scoped API key, auth headers, and the failure modes you will hit first. - [02 · Your first extraction | Trawl Guides](https://productcraft.co/docs/trawl/guides/02-first-extraction.md): Create an extraction job with every field explained, read the response, poll to a terminal status, list jobs with pagination, and cancel when you change your mind. - [03 · Schema design | Trawl Guides](https://productcraft.co/docs/trawl/guides/03-schema-design.md): Design JSON Schemas that extract well: shape rules, naming, required vs nullable, constraints that help vs constraints that hurt, and a worked example from naive to robust. - [04 · Webhooks | Trawl Guides](https://productcraft.co/docs/trawl/guides/04-webhooks.md): The Trawl webhook events (job.succeeded, job.failed, credits.low), what they carry, and how to get them; signatures, retries and replay are in the shared Webhooks guide. - [05 · Operations | Trawl Guides](https://productcraft.co/docs/trawl/guides/05-operations.md): Run Trawl in production: time budgets and the job reaper, what retries and what does not, observing failures via job status and webhook deliveries, cancel semantics, and a troubleshooting matrix. - [API Reference | Trawl Docs](https://productcraft.co/docs/trawl/api-reference.md): Full Trawl API reference. Extraction jobs, webhooks, delivery attempts — generated from the live OpenAPI spec. ## Flags - [Flags Documentation](https://productcraft.co/docs/flags.md): Feature flags and remote settings evaluated inside your app: percentage rollouts, targeting rules, segments, environments, change history and signed webhooks. Getting started, concepts, guides and the API reference. - [Getting started | Flags Docs](https://productcraft.co/docs/flags/getting-started.md): Turn Flags on, create a feature flag, read it from Node with local evaluation, a Redis cache and a bootstrap, and see a change in the console reach your app. - [Core concepts | Flags Docs](https://productcraft.co/docs/flags/concepts.md): Projects, configs and environments; flag types; the user object; targeting rules, comparators, segments and prerequisites; percentage rollouts; SDK keys; protected environments; revisions, caching and propagation time. - [Guides | Flags Docs](https://productcraft.co/docs/flags/guides.md): Flags guides: percentage rollouts, segments, OpenFeature, webhooks, testing with overrides, the config JSON and evaluation spec, fail-safe and caching, migrating from ConfigCat, React and Next.js, serverless, the kill-switch runbook and flag cleanup. - [01 · Percentage rollouts | Flags Guides](https://productcraft.co/docs/flags/guides/01-percentage-rollout.md): Staff first, then 10%, 50%, everyone: sticky buckets, the split attribute, and what anonymous users get. - [02 · Segments | Flags Guides](https://productcraft.co/docs/flags/guides/02-segments.md): One "Beta testers" list reused across flags, hashed emails, adding a tester without retyping the list. - [03 · OpenFeature | Flags Guides](https://productcraft.co/docs/flags/guides/03-openfeature.md): The ProductCraftFlagsProvider for the OpenFeature server SDK: context mapping, reasons, events, tests. - [04 · Webhooks | Flags Guides](https://productcraft.co/docs/flags/guides/04-webhooks.md): config.published and sdk_key.rotated: filter by environment, verify the signature, read what changed. - [05 · Testing with overrides | Flags Guides](https://productcraft.co/docs/flags/guides/05-testing-with-overrides.md): Local values, a JSON file or an environment variable; createTestClient in unit tests; test evaluation against the live config. - [06 · Config JSON and evaluation | Flags Guides](https://productcraft.co/docs/flags/guides/06-config-json-and-evaluation.md): The config JSON (schema 1), the evaluation spec and the test vectors, for authors of SDKs in other languages. - [07 · Fail-safe and caching | Flags Guides](https://productcraft.co/docs/flags/guides/07-fail-safe-and-caching.md): What your app evaluates when Flags is slow or down: the held config, your cache, the bootstrap, your defaults. - [08 · Migrating from ConfigCat | Flags Guides](https://productcraft.co/docs/flags/guides/08-migrating-from-configcat.md): Concept and SDK maps, the importer, sticky buckets, hashed values, a dual-run check and the cutover checklist. - [09 · React and Next.js | Flags Guides](https://productcraft.co/docs/flags/guides/09-react-and-nextjs.md): FlagsProvider and useFlag, server rendering from a bootstrap without a flash, and which key may ship to a browser. - [10 · Serverless and edge | Flags Guides](https://productcraft.co/docs/flags/guides/10-serverless.md): Lazy polling with a shared cache for functions, and the engine on its own at the edge. - [11 · Kill-switch runbook | Flags Guides](https://productcraft.co/docs/flags/guides/11-kill-switch-runbook.md): Turn a feature off for everyone during an incident, know when every app has it, and restore the targeting after. - [12 · Flag cleanup | Flags Guides](https://productcraft.co/docs/flags/guides/12-flag-cleanup.md): Temporary vs permanent flags, finding the ones that are done, removing them from code and then from Flags. - [API Reference | Flags Docs](https://productcraft.co/docs/flags/api-reference.md): Full Flags API reference: projects, environments, configs, settings and targeting, segments, SDK keys, history, test evaluation, webhooks and the ConfigCat import, generated from the live OpenAPI spec. ## Notify - [Notify Documentation](https://productcraft.co/docs/notify.md): One call notifies a user across an in-app inbox, email, web push, iOS and Android push, with preferences, fallbacks, quiet hours, templates, delivery history and signed webhooks. Getting started, concepts, guides and the API reference. - [Getting started | Notify Docs](https://productcraft.co/docs/notify/getting-started.md): Turn Notify on, create a category and a notification type, identify a user, send them a notification and read it from their inbox with a recipient token. - [Concepts | Notify Docs](https://productcraft.co/docs/notify/concepts.md): Recipients, categories, notification types, channels and routing, notifications and deliveries, states, preferences, critical types, quiet hours, scheduling, tenants, templates and recipient tokens. - [Guides | Notify Docs](https://productcraft.co/docs/notify/guides.md): Notify guides: sending from Node and other backends, types as code, React and Next.js inboxes, web push, iOS and Android push, React Native, email, scheduling, webhooks, idempotency, testing, erasure and migrating. - [01 · Send from Node | Notify Guides](https://productcraft.co/docs/notify/guides/01-send-from-node.md): identify, send to one or a thousand recipients, read the result, look a notification up, cancel and retract. - [02 · Python, Go, Ruby and curl | Notify Guides](https://productcraft.co/docs/notify/guides/02-other-backends.md): No Node SDK needed: the same send, recipient upsert and token mint over plain HTTP, from the OpenAPI spec. - [03 · Notification types as code | Notify Guides](https://productcraft.co/docs/notify/guides/03-types-as-code.md): Keep categories and types in your repo, apply them with PUT …/by-key on deploy, promote them from staging, export what you have. - [04 · An inbox in React | Notify Guides](https://productcraft.co/docs/notify/guides/04-react-inbox.md): The token route, and : bell, unread badge, real-time list, action buttons, theming. - [05 · Next.js App Router | Notify Guides](https://productcraft.co/docs/notify/guides/05-nextjs-app-router.md): A route handler that mints tokens from your session, a client provider in a Server Component tree, router navigation. - [06 · Vue, Svelte and plain JavaScript | Notify Guides](https://productcraft.co/docs/notify/guides/06-vue-and-vanilla.md): @productcraft/notify-js: the inbox store, real-time updates, marks and preferences without React. - [07 · A preferences screen | Notify Guides](https://productcraft.co/docs/notify/guides/07-preferences-ui.md): Categories with defaults, mandatory channels, , quiet hours and one-click email unsubscribe. - [08 · Web push in 10 minutes | Notify Guides](https://productcraft.co/docs/notify/guides/08-web-push.md): No Apple or Google account: keys Notify generates, a service worker, a button, a test send. Safari and iOS rules included. - [09 · iOS push (APNs) | Notify Guides](https://productcraft.co/docs/notify/guides/09-ios-push.md): Create an APNs key in your Apple Developer account, register tokens from Swift, sandbox vs production, time-sensitive and rich push. - [10 · Android push (FCM) | Notify Guides](https://productcraft.co/docs/notify/guides/10-android-push.md): A dedicated Firebase service account, google-services.json, registering tokens from Kotlin, notification channel ids. - [11 · React Native and Expo | Notify Guides](https://productcraft.co/docs/notify/guides/11-react-native-and-expo.md): Native APNs and FCM tokens (not Expo push tokens), the inbox with a streaming fetch, pausing in the background. - [12 · Devices, logout and data-only push | Notify Guides](https://productcraft.co/docs/notify/guides/12-devices-and-data-only-push.md): Register on every app start, unregister on logout, what pruning does, background (data-only) pushes. - [13 · Email through Mail | Notify Guides](https://productcraft.co/docs/notify/guides/13-email-via-mail.md): A Mail template per type, variables, suppression, bounces and complaints, the email budget and one-click unsubscribe. - [14 · Scheduling, cancellation and routing | Notify Guides](https://productcraft.co/docs/notify/guides/14-scheduling-and-routing.md): send_at and delay_seconds, cancellation keys, fallbacks, and "email only if the inbox item is still unread after 15 minutes". - [15 · Webhooks | Notify Guides](https://productcraft.co/docs/notify/guides/15-webhooks.md): The fourteen events, verifying signatures, reacting to failed deliveries, pruned devices and invalid credentials. - [16 · Idempotency and retries | Notify Guides](https://productcraft.co/docs/notify/guides/16-idempotency-and-retries.md): Deterministic Idempotency-Keys, what a retried send does, provider retries, and why a push can arrive twice but shows once. - [17 · Testing without devices | Notify Guides](https://productcraft.co/docs/notify/guides/17-testing-without-devices.md): dry_run and Explain, the inbox as a test channel, the SES mailbox simulator, mocks in unit tests, token caching. - [18 · Erasure and retention | Notify Guides](https://productcraft.co/docs/notify/guides/18-erasure-and-retention.md): Erase a recipient (and what Mail keeps), how long each record lives, linked Auth users, workspace deletion. - [19 · Migrating from Knock, Courier, OneSignal or Novu | Notify Guides](https://productcraft.co/docs/notify/guides/19-migrating.md): Concept map, bulk import with devices and preferences, keeping web push subscriptions, and a dual-run cutover. - [Limits and retention | Notify Docs](https://productcraft.co/docs/notify/limits.md): Notify preview limits per workspace and per recipient, payload sizes, rate limits with Retry-After, and how long notifications, deliveries, inbox items and devices are kept. - [Web push sender | Notify Docs](https://productcraft.co/docs/notify/web-push.md): Web push requests signed with this contact URL come from ProductCraft Notify on behalf of its customers. How to reach us about them. - [Why didn’t it arrive? | Notify Docs](https://productcraft.co/docs/notify/why-didnt-it-arrive.md): Every reason a Notify delivery can be skipped, held, retried or failed, what it means and how to fix it: the same registry the console and the MCP explain tool use. - [API Reference | Notify Docs](https://productcraft.co/docs/notify/api-reference.md): Full Notify API reference: notifications, recipients, devices, preferences, categories, notification types and templates, deliveries, recipient tokens, channels, settings, webhooks and the client API, generated from the live OpenAPI spec. ## API references (OpenAPI) - [Platform OpenAPI document](https://api.platform-auth.productcraft.co/docs-json): every Platform endpoint, request and response schema; the SDKs are generated from it. - [Auth OpenAPI document](https://api.auth.productcraft.co/docs-json): every Auth endpoint, request and response schema; the SDKs are generated from it. - [Mail OpenAPI document](https://api.mail.productcraft.co/docs-json): every Mail endpoint, request and response schema; the SDKs are generated from it. - [Waitlist OpenAPI document](https://api.waitlist.productcraft.co/docs-json): every Waitlist endpoint, request and response schema; the SDKs are generated from it. - [Social OpenAPI document](https://api.social.productcraft.co/docs-json): every Social endpoint, request and response schema; the SDKs are generated from it. - [Trawl OpenAPI document](https://api.trawl.productcraft.co/docs-json): every Trawl endpoint, request and response schema; the SDKs are generated from it. - [Flags OpenAPI document](https://api.flags.productcraft.co/docs-json): every Flags endpoint, request and response schema; the SDKs are generated from it. - [Notify OpenAPI document](https://api.notify.productcraft.co/docs-json): every Notify endpoint, request and response schema; the SDKs are generated from it.