Jobs

Create a job

Creates a new job in your organisation.

post/jobs

Request

  • Base URL: https://api.streamtime.net/v2
  • URL: https://api.streamtime.net/v2/jobs
  • Auth: HTTP bearer

Request body

idinteger

Job ID

companyIdinteger

The ID of the company this job belongs to

jobGroupIdinteger nullable

The ID of the job group this job belongs to

jobLeadUserIdinteger nullable

Job lead user ID

rateCardIdinteger

The id of the rate card used for this job

isBillableboolean

Is the job billable

exchangeRatenumber float

Exchange rate applied to this job

branchIdinteger nullable

The id of the branch this job belongs to

numberstring nullable

Job number

namestring

Job name

fullNamestring

Full job name

purchaseOrderNumberstring nullable

Client purchase order number

createdUserIdinteger

ID of the User who created the job

jobCreatedDatetimestring date

Job created date

estimatedStartDatestring date nullable

Estimated start date

estimatedEndDatestring date nullable

Estimated end date

completedDatetimestring date nullable

Completed date

archivedDatetimestring date nullable

Archived date

contactIdinteger nullable

The id of the contact this job is being done for

jobCurrencyBudgetnumber float nullable

Budget (Job Currency)

finalBudgetnumber float nullable

Final budget (approved quote total if available)

jobCurrencyFinalBudgetnumber float nullable

Final budget (Job Currency)

totalPlannedMinutesinteger nullable

Total planned minutes

totalPlannedTimeExTaxnumber float nullable

Total planned time ex tax (job currency)

totalPlannedExpensesExTaxnumber float nullable

Total planned expenses ex tax (job currency)

totalPlannedExpensesCostExTaxnumber float nullable

Total planned expenses cost ex tax (job currency)

totalIncompleteMinutesinteger nullable

Total incomplete minutes

totalIncompleteTimeExTaxnumber float nullable

Total incomplete time ex tax (job currency)

totalLoggedCostExTaxnumber float nullable

Total logged cost ex tax (job currency)

totalLoggedExTaxnumber float nullable

Total logged amount ex tax (job currency)

totalLoggedExpensesCostExTaxnumber float nullable

Total logged expenses cost ex tax (job currency)

totalLoggedExpensesExTaxnumber float nullable

Total logged expenses ex tax (job currency)

totalLoggedMinutesinteger nullable

Total logged minutes

totalLoggedTimeCostExTaxnumber float nullable

Total logged time cost ex tax (job currency)

totalLoggedTimeExTaxnumber float nullable

Total logged time ex tax (job currency)

totalInvoicedExTaxnumber float nullable

Total invoiced ex tax (job currency)

totalDraftInvoicesExTaxnumber float nullable

Total draft invoices ex tax (job currency)

totalAwaitingPaymentInvoicesExTaxnumber float nullable

Total awaiting payment invoices ex tax (job currency)

totalPaidInvoicesExTaxnumber float nullable

Total paid invoices ex tax (job currency)

totalIssuedInvoicesExTaxnumber float nullable

Total issued invoices ex tax (job currency)

totalApprovedQuoteExTaxnumber float nullable

Total approved quote ex tax (job currency)

Example request

{
  "id": 601,
  "companyId": 601,
  "jobGroupId": 601,
  "jobLeadUserId": 42,
  "isBillable": true,
  "exchangeRate": 1,
  "number": "JOB-2025-010",
  "name": "Website Redesign",
  "fullName": "ACME - Website Redesign",
  "purchaseOrderNumber": "PO-12345",
  "jobCreatedDatetime": "2025-01-02",
  "estimatedStartDate": "2025-01-10",
  "estimatedEndDate": "2025-02-28",
  "completedDatetime": "2025-03-15",
  "archivedDatetime": "2025-06-01",
  "jobCurrencyBudget": 22000,
  "finalBudget": 22000,
  "jobCurrencyFinalBudget": 22000,
  "totalPlannedMinutes": 480,
  "totalPlannedTimeExTax": 7500,
  "totalPlannedExpensesExTax": 1200,
  "totalPlannedExpensesCostExTax": 900,
  "totalIncompleteMinutes": 240,
  "totalIncompleteTimeExTax": 3200,
  "totalLoggedCostExTax": 5400,
  "totalLoggedExTax": 8600,
  "totalLoggedExpensesCostExTax": 750,
  "totalLoggedExpensesExTax": 980,
  "totalLoggedMinutes": 1260,
  "totalLoggedTimeCostExTax": 4200,
  "totalLoggedTimeExTax": 6800,
  "totalInvoicedExTax": 10000,
  "totalDraftInvoicesExTax": 1500,
  "totalAwaitingPaymentInvoicesExTax": 2500,
  "totalPaidInvoicesExTax": 6000,
  "totalIssuedInvoicesExTax": 8000,
  "totalApprovedQuoteExTax": 22000
}

Response

Job created.

idinteger

Job ID

companyIdinteger

The ID of the company this job belongs to

jobGroupIdinteger nullable

The ID of the job group this job belongs to

jobLeadUserIdinteger nullable

Job lead user ID

rateCardIdinteger

The id of the rate card used for this job

isBillableboolean

Is the job billable

exchangeRatenumber float

Exchange rate applied to this job

branchIdinteger nullable

The id of the branch this job belongs to

numberstring nullable

Job number

namestring

Job name

fullNamestring

Full job name

purchaseOrderNumberstring nullable

Client purchase order number

createdUserIdinteger

ID of the User who created the job

jobCreatedDatetimestring date

Job created date

estimatedStartDatestring date nullable

Estimated start date

estimatedEndDatestring date nullable

Estimated end date

completedDatetimestring date nullable

Completed date

archivedDatetimestring date nullable

Archived date

contactIdinteger nullable

The id of the contact this job is being done for

jobCurrencyBudgetnumber float nullable

Budget (Job Currency)

finalBudgetnumber float nullable

Final budget (approved quote total if available)

jobCurrencyFinalBudgetnumber float nullable

Final budget (Job Currency)

totalPlannedMinutesinteger nullable

Total planned minutes

totalPlannedTimeExTaxnumber float nullable

Total planned time ex tax (job currency)

totalPlannedExpensesExTaxnumber float nullable

Total planned expenses ex tax (job currency)

totalPlannedExpensesCostExTaxnumber float nullable

Total planned expenses cost ex tax (job currency)

totalIncompleteMinutesinteger nullable

Total incomplete minutes

totalIncompleteTimeExTaxnumber float nullable

Total incomplete time ex tax (job currency)

totalLoggedCostExTaxnumber float nullable

Total logged cost ex tax (job currency)

totalLoggedExTaxnumber float nullable

Total logged amount ex tax (job currency)

totalLoggedExpensesCostExTaxnumber float nullable

Total logged expenses cost ex tax (job currency)

totalLoggedExpensesExTaxnumber float nullable

Total logged expenses ex tax (job currency)

totalLoggedMinutesinteger nullable

Total logged minutes

totalLoggedTimeCostExTaxnumber float nullable

Total logged time cost ex tax (job currency)

totalLoggedTimeExTaxnumber float nullable

Total logged time ex tax (job currency)

totalInvoicedExTaxnumber float nullable

Total invoiced ex tax (job currency)

totalDraftInvoicesExTaxnumber float nullable

Total draft invoices ex tax (job currency)

totalAwaitingPaymentInvoicesExTaxnumber float nullable

Total awaiting payment invoices ex tax (job currency)

totalPaidInvoicesExTaxnumber float nullable

Total paid invoices ex tax (job currency)

totalIssuedInvoicesExTaxnumber float nullable

Total issued invoices ex tax (job currency)

totalApprovedQuoteExTaxnumber float nullable

Total approved quote ex tax (job currency)

Example response

{
  "id": 601,
  "companyId": 601,
  "jobGroupId": 601,
  "jobLeadUserId": 42,
  "isBillable": true,
  "exchangeRate": 1,
  "number": "JOB-2025-010",
  "name": "Website Redesign",
  "fullName": "ACME - Website Redesign",
  "purchaseOrderNumber": "PO-12345",
  "jobCreatedDatetime": "2025-01-02",
  "estimatedStartDate": "2025-01-10",
  "estimatedEndDate": "2025-02-28",
  "completedDatetime": "2025-03-15",
  "archivedDatetime": "2025-06-01",
  "jobCurrencyBudget": 22000,
  "finalBudget": 22000,
  "jobCurrencyFinalBudget": 22000,
  "totalPlannedMinutes": 480,
  "totalPlannedTimeExTax": 7500,
  "totalPlannedExpensesExTax": 1200,
  "totalPlannedExpensesCostExTax": 900,
  "totalIncompleteMinutes": 240,
  "totalIncompleteTimeExTax": 3200,
  "totalLoggedCostExTax": 5400,
  "totalLoggedExTax": 8600,
  "totalLoggedExpensesCostExTax": 750,
  "totalLoggedExpensesExTax": 980,
  "totalLoggedMinutes": 1260,
  "totalLoggedTimeCostExTax": 4200,
  "totalLoggedTimeExTax": 6800,
  "totalInvoicedExTax": 10000,
  "totalDraftInvoicesExTax": 1500,
  "totalAwaitingPaymentInvoicesExTax": 2500,
  "totalPaidInvoicesExTax": 6000,
  "totalIssuedInvoicesExTax": 8000,
  "totalApprovedQuoteExTax": 22000
}

Changes

No recorded changes to this operation across all 1 revision of this API.