Promotion - Tera Contracted Supplier API

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.

{
  "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.