# SynthCrew

> SynthCrew is an AI-agent-native outbound workspace: lead intelligence, campaign preparation, mailbox context, approvals, controlled action, replies, and durable state for humans and agents.

This file is a machine-oriented orientation layer, generated from `sdks/shared/agent-contract-v2.json`. It is not an API schema. Runtime capability is the authenticated, scope-filtered response from the served versioned manifest and OpenAPI document.

SynthCrew is independent from Instantly and makes no affiliation or feature-parity claim; that phrase is category framing only.

## Bootstrap

- Product: https://synthcrew.io/
- Sign in: https://mail.synthcrew.io/sign-in
- Sign up: https://mail.synthcrew.io/sign-up
- API base: https://api.synthcrew.io
- Contract version: 2
- Discovery: GET https://api.synthcrew.io/api/v2/agent/manifest
- Capabilities: GET https://api.synthcrew.io/api/v2/agent/capabilities
- OpenAPI: GET https://api.synthcrew.io/api/v2/agent/openapi.json
- Read-only self-test: GET https://api.synthcrew.io/api/v2/agent/self-test
- Connect an agent: https://synthcrew.io/docs/connect-agent
- Task-first quickstart: https://synthcrew.io/docs/agent-api
- Real workflow runtime: https://synthcrew.io/docs/agent-workflows
- Rendered SDK guide: https://synthcrew.io/docs/sdks
- Dated capabilities: https://synthcrew.io/docs/capabilities

## First run
1. Read this manifest and the public OpenAPI document.
2. Authenticate with a workspace-scoped agent key.
3. Read capacity, mailbox, and readiness before proposing work.
4. Preview an operation and preserve its fingerprint.
5. Request human approval only when the returned contract requires it.

Public pages explain the contract; they do not grant a capability, connect a mailbox, or authorize sending.

## Authentication and scope

- Header: `Authorization: Bearer $SYNTHCREW_AGENT_KEY`
- Boundary: one workspace, one scope-filtered key
- Required scopes are returned by the grant-filtered manifest; this generated orientation currently enumerates: automations:execute, campaigns:launch, campaigns:read, campaigns:write, dnc:read, dnc:write, drafts:read, drafts:write, exports:read, exports:write, growth:read, leads:read, leads:write, mailboxes:read, privacy:read, providers:read, providers:write, receipts:read, replies:read, replies:write, sequences:read, sequences:write, templates:read, templates:write, warmup:read, warmup:write, webhooks:manage.
- Never send a human password, Clerk JWT, OAuth authorization code, provider token, webhook secret, or a key from another workspace.
- Legacy/unversioned manifests are not callable truth. Use only the versioned routes and capabilities returned by the authenticated contract.

## Capacity-first workflow

1. Read authenticated GET https://api.synthcrew.io/api/billing/usage before mailbox, campaign, or send work.
2. Inspect mailbox and daily-send used/limit/remaining plus daily reset_at.
3. Stay within returned capacity; never split or replay work to bypass a limit.
4. Branch on typed status/code recovery. 402 asks an owner to choose a plan; 403 preserves the action for an owner; 409 waits or resolves the conflict; 429 honors Retry-After and reset_at.

## Mutation envelope

Every mutation uses the headers declared by the canonical artifact: Authorization: Bearer $SYNTHCREW_AGENT_KEY; X-API-Version: 2. Preview before applying side effects, preserve the same idempotency key when recovering a timeout, and read the terminal receipt. An agent key cannot self-approve.

## Human and provider boundary

OAuth sign-in, Gmail consent, MFA, provider permissions, billing checkout, and higher-impact approval are human events. Agents can prepare, inspect, and guide them; they cannot obtain a password, bypass consent, impersonate a user, or operate an unconnected mailbox. A successful self-test is side-effect free and is not delivery proof.

## Public product truth

Published plans describe workspace capacity. Provider readiness, availability, permissions, and deliverability are workspace facts and are not guaranteed by this document. See https://synthcrew.io/docs/agent-api and the served contract for current details.

## Machine-readable references

- Human-readable contract: docs/agent-contract.md
- Machine artifact: sdks/shared/agent-contract-v2.json
- Raw catalog download: docs/api-catalog.json
- Capability matrix download: capabilities.json
- Marketing docs: https://synthcrew.io/docs