Skip to main content

Nature Webhooks

The Nature API fires two events. See Concepts: Webhooks for setup, signing, and retry behavior.

nature.assessment.completed​

Fired when all item responses have been received and scoring has completed. The profile is ready to retrieve.

{
  "type": "nature.assessment.completed",
  "data": {
    "assessment_id": "asm_xyz789",
    "subject_id": "sub_abc123",
    "profile_id": "prf_qrs456",
    "livemode": false
  },
  "created_at": "2026-04-21T10:35:00Z",
  "webhook_id": "evt_aaa111"
}

After receiving this event, call GET /v1/nature/subjects/{subject_id}/profile to retrieve scores and narratives.

nature.profile.updated​

Fired when a subject's profile is updated — either from a new assessment completing or a manual re-score.

{
  "type": "nature.profile.updated",
  "data": {
    "subject_id": "sub_abc123",
    "profile_id": "prf_new789",
    "previous_profile_id": "prf_old456",
    "livemode": false
  },
  "created_at": "2026-04-21T11:00:00Z",
  "webhook_id": "evt_bbb222"
}