# Account Coordination

> Derive an immutable account-level preflight from a reviewed Audience and its Outcome evidence.

Canonical guide: <https://api.blackpearl.com/docs/account-coordination>

Raw Markdown: <https://api.blackpearl.com/docs/raw/account-coordination.md>

OpenAPI: <https://api.blackpearl.com/v1/openapi.json>

Account Coordination is a Preview, deterministic assessment over existing Blackpearl data. It detects risks such as contacting too many people at one account, stale evidence, restrictive feedback, and retry timing. It does not generate copy, assign a sender, create a task, mutate a CRM, or authorize contact.

Preview operation `create_account_coordination_assessment_v1_account_coordination_assessments_post` binds a caller key, `audience_id`, exact Audience result hash, company domain, expected policy version, and audit reason. The Audience must belong to the current project and API-key environment. Its immutable member snapshot and relevant append-only Outcomes are evaluated atomically.

```bash
curl --fail-with-body --silent --show-error \
  --request POST "$BLACKPEARL_API_BASE_URL/v1/account-coordination-assessments" \
  --header "Authorization: Bearer $BLACKPEARL_API_KEY" \
  --header "Content-Type: application/json" \
  --data "{
    \"key\": \"acme-preflight-20260717\",
    \"audience_id\": \"$AUDIENCE_ID\",
    \"expected_audience_result_hash\": \"$AUDIENCE_RESULT_HASH\",
    \"company_domain\": \"acme.example\",
    \"expected_policy_version\": \"2026-07-15\",
    \"reason\": \"Preflight before external campaign review\"
  }"
```

An exact key/request replay returns the existing assessment; a changed request under the same key conflicts. The result preserves evidence references, derived flags, decision, and any `retry_after` bound to the assessment policy version.

Preview operation `get_account_coordination_assessment_v1_account_coordination_assessments__assessment_id__get` reads one immutable assessment. Treat the decision as a preflight signal for a separately governed delivery system, never as consent or send authority.