---
title: "Create Manual Creditor"
method: POST
path: "/v1/matters/{matter_id}/creditors/actions/create-manual"
tags: ["creditors"]
---

# Create Manual Creditor

`POST /v1/matters/{matter_id}/creditors/actions/create-manual`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/matters/{matter_id}/creditors/actions/create-manual`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Request body

- CreateManualCreditor
  - `creditor_id` string, uuid, required
  - `display_name` string, required
  - `creditor_class` 'priority' | 'secured' | 'unsecured' | 'employee', required
  - `relationship_status` 'unknown' | 'not_related' | 'related', required
  - `entity_type` 'company' | 'individual' | 'trust' | 'government' | 'other'
  - `abn` string, nullable
  - `acn` string, nullable
  - `contacts` ManualContactFact[]
    - `kind` 'contact_person' | 'email' | 'phone' | 'mobile' | 'home_address' | 'postal_address', required
    - `value` string, required
  - `claims` ClaimFactInput[]
    - `claim_id` string, uuid, nullable
    - `revision_id` string, uuid, nullable
    - `amount` string, decimal, required
    - `currency` string, required
    - `status` 'draft' | 'lodged' | 'awaiting_information' | 'partly_admitted' | 'admitted' | 'rejected' | 'withdrawn', required
    - `basis` 'book' | 'proof_of_debt' | 'rocap', required
    - `balance_as_at` string, date, nullable
    - `lodged_on` string, date, nullable
    - `admitted_amount` string, decimal, nullable
    - `treatment` 'secured' | 'priority' | 'unsecured' | 'subordinated'
    - `description` string, nullable
    - `secured_asset_details` string, nullable
    - `ppsr_registration` string, nullable
    - `provenance` object
  - `liquidation_estimate_amount` string, decimal, nullable

## Response `201`

Successful Response

- CreditorMutationResult
  - `creditor` CreditorDetail, required
    - `creditor` CreditorSnapshotItemV2, required
      - `id` string, uuid, required
      - `display_name` string, required
      - `profile_state` 'candidate' | 'confirmed', required
      - `creditor_class` 'priority' | 'secured' | 'unsecured' | 'employee', required
      - `relationship_status` 'unknown' | 'not_related' | 'related', required
      - `aliases` string[], required
      - `abn` string, nullable, required
      - `acn` string, nullable, required
      - `identifier_conflicts` string[], required
      - `sources` SourceView[], required
        - `id` string, uuid, required
        - `kind` 'employee' | 'repository_folder' | 'xero_contact' | 'matter_rollover', required
        - `authority` string, required
        - `identity` string, required
        - `observed_at` string, date-time, required
        - `provenance_json` string, required
      - `contacts` ResolvedContactV1[], required
        - `kind` 'contact_person' | 'email' | 'phone' | 'mobile' | 'home_address' | 'postal_address', required
        - `selected_observation_id` string, uuid, nullable, required
        - `conflict` boolean, required
        - `observations` ContactObservationView[], required
          - `id` string, uuid, required
          - `kind` 'contact_person' | 'email' | 'phone' | 'mobile' | 'home_address' | 'postal_address', required
          - `value` string, required
          - `normalized_value` string, required
          - `source_kind` 'employee' | 'practitioner' | 'spreadsheet' | 'xero_contact' | 'matter_rollover', required
          - `source_link_id` string, uuid, nullable, required
          - `observed_at` string, date-time, required
          - `practitioner_confirmed` boolean, required
          - `confirmed_at` string, date-time, nullable, required
          - `provenance_json` string, required
      - `claims` ClaimRevisionView[], required
        - `id` string, uuid, required
        - `claim_id` string, uuid, required
        - `revision_number` integer, required
        - `amount` string, decimal, required
        - `currency` string, required
        - `status` 'draft' | 'lodged' | 'awaiting_information' | 'partly_admitted' | 'admitted' | 'rejected' | 'withdrawn', required
        - `basis` 'book' | 'proof_of_debt' | 'rocap', required
        - `balance_as_at` string, date, nullable, required
        - `lodged_on` string, date, nullable, required
        - `admitted_amount` string, decimal, nullable, required
        - `treatment` 'secured' | 'priority' | 'unsecured' | 'subordinated', required
        - `created_at` string, date-time, required
        - `provenance_json` string, required
      - `evidence` EvidenceReferenceView[], required
        - `id` string, uuid, required
        - `claim_id` string, uuid, nullable, required
        - `claim_revision_id` string, uuid, nullable, required
        - `role` 'pod' | 'support' | 'payment' | 'mixed' | 'other', required
        - `memory_document_id` string, uuid, nullable, required
        - `matter_document_id` string, uuid, nullable, required
        - `memory_generation_id` string, uuid, nullable, required
        - `processing_status` 'pending' | 'indexed' | 'retryable_failure' | 'terminal_failure' | 'outside_boundary', required
        - `repository_source_item_id` string, uuid, nullable, required
        - `element_ids` string[], required
        - `provenance_json` string, required
    - `entity_type` 'company' | 'individual' | 'trust' | 'government' | 'other', required
    - `liquidation_estimate_amount` string, decimal, nullable, required
    - `profile_updated_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `archived_at` string, date-time, nullable, required
    - `claim_details` ClaimRevisionDetailView[], required
      - `id` string, uuid, required
      - `claim_id` string, uuid, required
      - `revision_number` integer, required
      - `amount` string, decimal, required
      - `currency` string, required
      - `status` 'draft' | 'lodged' | 'awaiting_information' | 'partly_admitted' | 'admitted' | 'rejected' | 'withdrawn', required
      - `basis` 'book' | 'proof_of_debt' | 'rocap', required
      - `balance_as_at` string, date, nullable, required
      - `lodged_on` string, date, nullable, required
      - `admitted_amount` string, decimal, nullable, required
      - `treatment` 'secured' | 'priority' | 'unsecured' | 'subordinated', required
      - `created_at` string, date-time, required
      - `provenance_json` string, required
      - `description` string, nullable, required
      - `ppsr_registration` string, nullable, required
      - `secured_asset_details` string, nullable, required
    - `contact_history` ContactObservationHistoryView[], required
      - `id` string, uuid, required
      - `kind` 'contact_person' | 'email' | 'phone' | 'mobile' | 'home_address' | 'postal_address', required
      - `value` string, required
      - `normalized_value` string, required
      - `source_kind` 'employee' | 'practitioner' | 'spreadsheet' | 'xero_contact' | 'matter_rollover', required
      - `source_link_id` string, uuid, nullable, required
      - `observed_at` string, date-time, required
      - `practitioner_confirmed` boolean, required
      - `confirmed_at` string, date-time, nullable, required
      - `provenance_json` string, required
      - `supersedes_observation_id` string, uuid, nullable, required
    - `claim_history` ClaimRevisionHistoryView[], required
      - `id` string, uuid, required
      - `claim_id` string, uuid, required
      - `revision_number` integer, required
      - `amount` string, decimal, required
      - `currency` string, required
      - `status` 'draft' | 'lodged' | 'awaiting_information' | 'partly_admitted' | 'admitted' | 'rejected' | 'withdrawn', required
      - `basis` 'book' | 'proof_of_debt' | 'rocap', required
      - `balance_as_at` string, date, nullable, required
      - `lodged_on` string, date, nullable, required
      - `admitted_amount` string, decimal, nullable, required
      - `treatment` 'secured' | 'priority' | 'unsecured' | 'subordinated', required
      - `created_at` string, date-time, required
      - `provenance_json` string, required
      - `description` string, nullable, required
      - `ppsr_registration` string, nullable, required
      - `secured_asset_details` string, nullable, required
      - `supersedes_revision_id` string, uuid, nullable, required
    - `communications` CommunicationView[], required
      - `id` string, uuid, required
      - `claim_id` string, uuid, nullable, required
      - `claim_revision_id` string, uuid, nullable, required
      - `channel` 'email' | 'phone' | 'letter' | 'meeting' | 'other', required
      - `direction` 'inbound' | 'outbound', required
      - `occurred_at` string, date-time, required
      - `occurred_time_known` boolean, required
      - `subject` string, nullable, required
      - `notes` string, required
      - `external_message_id` string, nullable, required
      - `created_at` string, date-time, required
    - `document_labels` CreditorDocumentLabelView[], required
      - `evidence_reference_id` string, uuid, required
      - `display_name` string, required
    - `repository_evidence_states` RepositoryEvidenceStateView[], required
      - `status` 'pending' | 'indexed' | 'retryable_failure' | 'terminal_failure' | 'outside_boundary', required
      - `display_label` string, required
      - `evidence_reference_id` string, uuid, nullable, required
      - `memory_document_id` string, uuid, nullable, required
      - `role` 'pod' | 'support' | 'payment' | 'mixed' | 'other', required
      - `safe_issue_code` string, nullable, required
      - `updated_at` string, date-time, required
    - `repository_folder_ready` boolean, required
    - `portal_reviews` unknown[], required
      - unknown
  - `replayed` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/bf4373130521?raw)