Integration requirements

Everything an integration submission needs. Each topic is plain markdown at a stable URL — your agent can fetch them directly, or get the same content through the MCP server's guidance tools.

Submission overview

What a complete integration submission contains and how review works.

Authentication patterns

The five onboarding shapes AO supports; pick exactly one.

Event taxonomy & samples

Canonical event naming, id strategies, and what sample payloads must show.

Webhook contract

Signature schemes, required headers, delivery semantics.

Inventory sync (poll surface)

What your list APIs need so AO can sync resource inventory.

Logo & brand assets

Asset formats the AO catalog tile accepts.

No API yet? Track 1 — emit events to AO today

Integrate this week by sending AO-canonical events to customer webhook URLs.

No API yet? Track 2 — build a native surface

The webhook/OAuth/inventory design that graduates you to a first-class tile.

Dossier requirements

The prose half of a submission: contacts, docs links, limits, setup steps.

Manifest JSON Schema: /schemas/submission.schema.json