> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://catena.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://catena.ferndocs.com/_mcp/server.

# Share agreement created

POST 

Emitted when a new share agreement is created.

Reference: https://catena.ferndocs.com/api-reference/notifications/webhook-events/share-agreement-created

## Request

### Payload

- `version` (string, required) — Version of the schema used for this event
- `data` (list of BaseShareAgreementEvent, required) — The event payload, with one or more records of the specified type
- `webhook_id` (string, required) — Unique identifier for the webhook subscription that triggered this delivery
- `event_name` (string, optional, default: share_agreement.created)
- `timestamp` (datetime, optional, nullable) — ISO 8601 timestamp when the event occurred
- `id` (string, optional, nullable) — Unique identifier for this specific event instance (UUID v7 for time-ordered sorting)
- `delivery_attempt` (integer, optional, default: 0) — The number of times the event has been attempted to be delivered

## Types

### BaseShareAgreementEvent

Base share agreement event.

- `id` (string, required) — The ID of the share agreement
- `fleet_id` (string, required) — The Catena ID of the fleet.
- `partner_id` (string, required) — The Catena ID of the partner.
- `status` (enum, required) — The status of the share agreement
  - Allowed values: `active`, `inactive`, `paused`, `expired`, `cancelled`, `pending`, `deleted`, `stale`, `success`, `failed`, `scheduled`, `accepted`, `declined`
- `scopes` (map from string to string, required) — The scopes/resources that are shared between the fleet and the partner
- `fleet_ref` (string, optional, nullable) — The reference of the fleet in the partner system
- `effective_date` (datetime, optional, nullable) — The date and time the share agreement became effective
- `expiration_date` (datetime, optional, nullable) — The date and time the share agreement will expire