> ## Documentation Index
> Fetch the complete documentation index at: https://docs.terabusinessfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Promotion

> Explicitly turn an accepted basic submission into exactly one Application.

Promotion is a dedicated operation on the **same** submission. Tera never auto-promotes a basic submission because optional fields happen to be present.

Supplier-driven promotion requires the `supplier_submissions:promote` scope.

## Contract

The body is the application-level Phase A contract **without** `external_reference` or `level`. Send a new `operation_idempotency_key` in the JSON body.

Synthetic example: promote Northbridge Tea Rooms Ltd after the basic submission is `accepted`.

```json theme={null}
{
  "operation_idempotency_key": "promote-northbridge-1001-01",
  "first_name": "Amelia",
  "last_name": "Hart",
  "email": "amelia.hart@example.test",
  "telephone": "07700 900123",
  "business_name": "Northbridge Tea Rooms Ltd",
  "business_structure": "limited-company",
  "business_sector": "hospitality",
  "trading_duration": "2-5-years",
  "annual_turnover_range": "100k-250k",
  "funding_amount": 25000,
  "funding_purpose": "working-capital",
  "funding_timeframe": "within-1-month",
  "preferred_contact_method": "phone",
  "company_number": "00000001",
  "privacy_information": {
    "provided": true,
    "wording_version": "supplier-v1-pending",
    "captured_at": "2026-08-29T11:00:00.000Z"
  },
  "contact_expectation": {
    "permission_stated": true,
    "channels": ["phone", "email"],
    "wording_version": "supplier-v1-pending",
    "captured_at": "2026-08-29T11:00:00.000Z"
  },
  "marketing": false,
  "capture_timestamp": "2026-08-29T11:00:00.000Z",
  "attribution": { "source": "sandbox-guide" }
}
```

## Acknowledgements

| HTTP    | Meaning                                     |
| ------- | ------------------------------------------- |
| **202** | Promotion accepted for processing           |
| **200** | Idempotent replay of the same operation key |

On success, later polls show `application_reference` and `application_created_at` on the same `submission_id`. Concurrent promotions converge on **one** Application.